This chapter contains the guidelines you must comply with if your application uses immediate execution for its SpotPass tasks. If your application performs immediate execution, you must comply with this chapter as well as with chapter 6.14 BOSS: Common Items.
As much as possible, avoid using the term "SpotPass" in regard to immediate-execution NADL tasks.
It is possible to receive only notifications using an immediate-execution task, but Nintendo does not recommend doing so, as this might cause problems such as duplicate distribution.
6.16.1 Supporting One-time Immediate-Execution Download Tasks
Nintendo strongly recommends against using the term SpotPass in any messages displayed when running a one-time download task where you do not intend to periodically perform the download again. Instead, Nintendo recommends simply calling it a download, with phrasing such as “Download this content?” or “Could not download due to X.”
No required guideline items.
6.16.2 Task Settings for Immediate Execution
Use the following settings for immediate-execution tasks (including FGONLYT tasks).
Execution priority |
Use the default value of PRIORITY_MEDIUM. Contact Nintendo at support@noa.com before setting any other value. |
Access point information |
Do not provide this information. Contact Nintendo at support@noa.com in advance if you plan to use immediate-execution tasks that provide access point information. |
Task permissions |
Set a value of TASK_PERMISSION_IN_PARENTAL_CONTROL. Although this is the default value, set it explicitly using the SetProperty function of the nn::boss::TaskPolicy class. |
Task ID | Use FGONLYT or the task ID that you used on your application to Nintendo. |
6.16.2.1 Compliance with Task Settings for Immediate Execution
Guideline Item |
The settings for immediate-execution tasks (including FGONLYT tasks) must follow the standards established by Nintendo.
|
---|---|
Software to Be Tested |
Applications that register immediate-execution tasks.
|
Test Method |
Check the source code.
|
Pass/Fail Determination |
Passes if all of the following conditions are met.
|
6.16.3 Displaying Errors during Immediate Execution
If an error occurs when the user executes an NADL task or a DataStore download or upload task, display the error code and a message on-screen. However, you do not need to display this if the application automatically retries and successfully completes the task. See section 6.3.1 Displaying Errors During Internet Communication for details on displaying errors.
6.16.3.1 Error Handling during Immediate Execution
Guideline Item |
The application must implement error handling when using immediate execution for downloads that are actively initiated by the user. |
---|---|
Software to Be Tested |
Applications which use the BOSS API to allow users to actively initiate downloads or uploads. |
Exceptions |
When the application automatically retries an operation and completes it without any problems. |
Test Method |
|
Pass/Fail Determination |
Passes if errors are displayed correctly using all of the below criteria.
|