Code-Link

SDK 最低版本：3.0.0

• 设置 Code-Link。
• 使用 Code-Link 登录。

设置 Code-Link

1. 将 Unity Authentication 中的 ID 提供商设置为 Code-Link：
   1. 在 Unity 编辑器菜单中，转到 Edit（编辑）> Project Settings...（项目设置...），然后选择 Services（服务）> Authentication（身份验证）。
   2. 将 ID Providers（ID 提供商） 设置为 Code-Link，然后选择 Add（添加）。
   3. 选择 Save（保存）。

使用 Code-Link 登录

1. 玩家以匿名方式或使用任意受支持的 ID 提供商登录设备 A。
2. 玩家决定在设备 B（尚未登录）使用相同的帐户，并让设备 B 生成登录代码。
3. 收到登录代码后，玩家在设备 A 上输入该代码来确认该代码已获授权。
4. 玩家返回设备 B 并请求使用代码登录。
5. 设备 B 使用与设备 A 上相同的帐户完成身份验证。

1. 从要进行身份验证的未认证设备使用

   GenerateSignInCodeAsync

   方法（回传标识符非必选项，但推荐使用该操作来识别生成登录代码的设备）生成登录代码。
2. 向玩家显示生成的 SignInCode 和过期时间。
   注意

   注意：标识符的最大长度为 128 个字符。

   async Task GenerateCodeAsync(string identifier){    try    {        var codeInfo = await AuthenticationService.Instance.GenerateSignInCodeAsync(identifier);        // Display code, and expiration and identifier to the player    }    catch (Exception e)    {        // Notify the client something went wrong generating the code    }}

3. 让玩家可以在另一台已经过身份验证的设备上输入该 SignInCode。
4. （可选）通过

   GetSignInCodeInfoAsync

   ，使用玩家提供的 SignInCode 来获取 SignInCode 信息，并向玩家显示该信息，以便玩家比较两台设备上的标识符，以此确认是否在为正确的设备授权。
5. 通过

   ConfirmCodeAsync

   授权 Code-Link 登录。
   注意

   注意：

   ConfirmCodeAsync

   方法还支持在 idProvider 和 externalToken 中使用可选的参数。这些参数只应在控制台中使用，如果从控制台客户端使用，则会返回错误。

   async Task GetCodeInfoAsync(string signInCode){    try    {        var codeInfo = await AuthenticationService.Instance.GetSignInCodeInfoAsync(signInCode);        // Display code, and expiration and identifier to the player and ask them to authorize the code-link sign in    }    catch (Exception e)    {        // Notify the client something went wrong getting the code information    }}async Task ConfirmCodeAsync(string signInCode){try{await AuthenticationService.Instance.ConfirmCodeAsync(signInCode);// Display a confirmation that the device should be authorized}catch (Exception e){// Notify the client something went wrong with the code confirmation}}

6. 通过调用

   SignInWithCodeAsync

   ，在生成 SignInCode 的同一设备上登录玩家。（用于验证 Code-Link 登录的凭据储存在内存中，因此请确保先调用 GenerateSignInCodeAsync，然后再调用 SignInWithCodeAsync，否则会抛出异常。）如果代码尚未得到授权，则此方法成功，但用户不会登录；请检查是否出现 SignedIn 事件，以判断登录是否成功。

   public async Task SignInWithCodeAsync(){    try    {        AuthenticationService.Instance.SignedIn += UserHasSignedIn        await AuthenticationService.Instance.SignInWithCodeAsync();    }    catch (Exception e)    {        // Notify the client something went wrong signing in the player    }    finally    {        AuthenticationService.Instance.SignedIn -= UserHasSignedIn    }}public void UserHasSignedIn() {    // Notify the client the user signed in successfully.}

<Note>**注意**：`SignInWithCodeAsync` 方法还支持自动轮询（每 5 秒钟轮询一次），因此设备会在该代码获得授权后自动使玩家登录，如果代码已过期，则会抛出异常。此方法还接受 `CancellationToken` 取消轮询。```csCancellationTokenSource CodeLinkCancellationTokenSource;</Note>public async Task PollSignInWithCodeAsync()\{    try    \{        CodeLinkCancellationTokenSource = new CancellationTokenSource();        await AuthenticationService.SignInWithCodeAsync(true, CodeLinkCancellationTokenSource.Token);    }    catch (Exception e)    \{        // Notify the client something went wrong with Polling for Code Confirmation    }}public void CancelSignInWithCode()\{    CodeLinkCancellationTokenSource.Cancel();}