Switch

本文旨在介绍如何设置 Nintendo Switch 身份验证，让您的游戏可以使用 Player Network 登录鉴权服务通过 Nintendo Switch 渠道登录。

前提条件

1. Register for an account and create a channel

Games should apply for Nintendo developer accounts on their own, create their game app using the developer account, then enter respective configurations on Player Network.

警告

Games must apply a different set of client ID and client secret for the development version and release version to deploy to different server environments.

For more information, see The Client ID and Secret and Nintendo Switch Independent Server Setup Manual.

Field	Type	Description
switch_app_id	string	Switch app ID
redirect_uri	string	Login redirect URI for mobile devices
client_id	string	Switch assigned client ID
client_secret	string	Switch assigned client secret

Create Product

1. Log in to Nintendo Developer Portal.

2. Go to MY PRODUCTS.

3. In the Products section, click Create Product.

   

   注意

   Select a region other than China.

Issue Game Code

1. Go to the specific products page.

2. From the top right corner, click Issue Game Code to generate switch_app_id.

   

Enter socket and HTTP communication usage

If it is not a stand-alone game, the app description says "There is communication with the original server", then add a project with the following information.

Apply for client_id and client_secret

1. Enter OMAS2 with Nintendo Developer ID and password.

2. Enter the required information as shown in the image.

   

   注意

   If the app is not open to China market, do not enter China in the field marked by number 4.

   In the testing stage, you may enter any redirect URI in the field marked by number 6. However, games should update this field to the actual redirect URI before releasing the game. This field can be modified after the application is completed.

3. Get client_id and client_secret once the application is approved.

Get app configuration for Nintendo

Contact business representatives from the Nintendo Collaboration Department to apply for a Nintendo app and get the corresponding app configuration information, which is the applicationId.

2. Create an account for Player Network Console.
3. Create a new project for your game, or join an existing one.
4. Download the SDK.
5. Integrate the SDK.
6. Add Nintendo as an authentication method for your project on Player Network Console.

步骤1：Complete Player Network SDK Configurations

Unity

说明

Version requirements:
Nintendo SDK 9.41
Unity 2019.3.13f1

Through the non-editable SwitchPreProcess.cs script, INTLSDK copies the configuration files INTLConfig.ini and INTLResultMsg.json to the StreamingAssets folder, then packages them together into the NSP file, which can then be read by INTLSDK.

The NSP file structure is as follows:

Unreal Engine

说明

Version requirements:
Unreal Engine 4.26 non-public version

Switch games enable players to select their account by default when the game starts. As Unreal Engine retrieves player account by default, INTLSDK may crash due to repeated retrieving player account. Therefore, games need to update the Unreal Engine source code.

Delete the code to automatically obtain player account when game starts in the FSwitchPlatformMisc::GetUidForControllerId(int32 ControllerId, struct nn::account::Uid& Uid) function from SwitchPlatformMisc.cpp

Through the INTLPlugin.Build.cs script, INTLSDK creates a new INTLSDK folder in the NSP package, and copies the configuration files INTLConfig.ini and INTLResultMsg.json to the new INTLSDK folder, which can then be read by INTLSDK.

The NSP file structure is as follows:

Adjust file path

For games to adjust the file path as needed:

1. Update the file path for INTLConfig.ini and INTLResultMsg.json in INTLPlugin.Build.cs according to their actual paths in the game project.

   

2. Update the corresponding file path in INTLWrapper.cpp.