Windows

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

前提条件

1. 在 Apple Developer Center 上配置 iOS 应用

1. 创建 App ID

创建一个 client_id 作为向 Apple 发送请求的来源。
iOS 应用的 client_id 为 App ID（Bundle ID）。

1. 登录 Apple 开发者平台。

2. 在侧边栏中，点击 Certificates, Identifiers & Profiles。

3. 在侧边栏中，点击 Identifiers，然后点击蓝色添加图标（+）。

   

4. 选择 App IDs，然后点击 Continue。

   

5. 输入 Description 和 Bundle ID。

   • Description：游戏应用的名称或描述。
   • Bundle ID：游戏应用的唯一标识符，包含在 App ID 中。

   

6. 在 Capabilities 下，选择 Sign in with Apple，然后点击 Continue。

7. 点击 Register 创建 App ID。

说明

对于现有的 App ID，找到该 App ID 后在 Capabilities 下选择 Sign in with Apple。

2. 创建用于访问服务的密钥

创建用于计算 client_secret 的密钥和相应的 Key ID。

1. 在 Certificates, Identifiers & Profiles，点击侧边栏中的 Keys。

2. 点击蓝色添加图标（+）。

   

3. 在 Key Name 下，输入密钥的唯一名称。

4. 选择 Sign in with Apple 旁边的复选框，然后点击 Configure。

   

5. 在 Primary App ID 下，选择在 上一步 中创建的 App ID，然后点击 保存。

   

6. 点击 Continue。

7. 点击 Register 生成密钥，并记下 Key ID。

8. 点击 Download 下载密钥文件（只能下载一次，切勿丢失），该文件保存为文件后缀 .p8 的文本文件。

3. 创建描述文件

创建并下载描述文件，然后，在开发或打包环境中安装下载的描述文件。

4. 获取 Team ID

1. 登录 Apple 开发者平台。

2. 在侧边栏中，点击 Membership 来查看 Team ID。

   

有关 Apple 开发者平台配置的更多信息，请参见 What the Heck is Sign In with Apple?。

2. 获取 Player Network 控制台登录账号。
3. 为游戏创建新项目，或加入已有项目。
4. 下载 SDK。
5. 接入 SDK。
6. 在 Player Network 控制台添加 Apple 为业务的登录鉴权方式。

步骤1：为 Apple 登录配置 SDK

打开项目的 INTLConfig.ini 文件：

[Apple]
APPLE_WEB_APP_ID = {INTL_APPLE_WEB_APP_ID}

将 {INTL_APPLE_WEB_APP_ID} 替换为游戏的 Apple Web APPLICATION ID。

步骤2：添加 Apple 登录

警告

1. Apple 登录是无法在重签包测试的，建议使用 TestFlight 或者 Dev 的打包。
2. Apple 登录不提供 PictureUrl（用户头像 URL）。更多信息，请参见 Unity 引擎的 INTLAuthResult 或 Unreal Engine 的 FINTLAuthResult。

Login 接口的登录权限参数传入 email 和 fullName：

• 在首次登录的界面中有编辑用户名和隐藏邮箱的选项（Fig 2）。在回调中可以获取 email 和 fullName。
  • 玩家选择隐藏邮箱，获取的邮箱为随机邮箱地址
  • 玩家选择共享邮箱，获取到用户的真实邮箱地址
• 后续登录不会获取到 email 和 fullName，登录界面（Fig 2），没有编辑用户名和隐藏邮箱选项。
• 如果玩家停止 app 使用 Apple ID 后再次登录，会显示 Fig 1 所示选项。

说明

玩家可以选择 设置 > [您的用户名] > 密码和安全 > 使用 Apple ID > [应用名称] > 停止使用 Apple ID 来停止让 app 继续使用 Apple ID 登录。

在 Login 接口的登录权限参数传入空字符串时，登录界面没有编辑用户名和隐藏邮箱的选项（Fig 2）。在回调中 email 和 fullName 为空。

Fig 1:

Fig 2:

1. 注册登录相关回调。

   Unity

   // Add callbacks
   public void AddAuthObserver()
   {
       INTLAPI.AddAuthResultObserver(OnAuthResultEvent);
   }
   
   // Remove callbacks
   public void RemoveAuthObserver()
   {
       INTLAPI.RemoveAuthResultObserver(OnAuthResultEvent);
   }
   
   // Process the INTLAuthResult callback
   public void OnAuthResultEvent(INTLAuthResult ret)
   {
       Debug.Log($"MethodID: {ret.MethodId}");
       
       string methodTag = "";
       if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_LOGIN)
       {
           methodTag = "Login";
       }
       else if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_BIND)
       {
           methodTag = "Bind";
       }
       else if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_AUTOLOGIN)
       {
           methodTag = "AutoLogin";
       }
       else if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_QUERY_USER_INFO)
       {
           methodTag = "QueryUserInfo";
       }
       else if (authRet.MethodId == (int)INTLMethodID.INTL_AUTH_GET_AUTH_RESULT)
       {
           methodTag = "GetAuthResult";
       }
   }

   Unreal Engine

   C++ Event Handling (above v1.15)

   //configure callback
   FINTLAuthEvent authEvent;
   authEvent.AddUObject(this, &OnAuthResult_Implementation);
   UINTLSDKAPI::SetAuthResultObserver(authEvent);
   // Remove callbacks
   UINTLSDKAPI::GetAuthResultObserver().Clear();

   void OnAuthResult_Implementation(FINTLAuthResult ret)
   { 
       UE_LOG(LogTemp, Warning, TEXT("MethodID: %d"), ret.MethodId);
   }

   Unreal Event Handling

   void OnAuthResult_Implementation(FINTLAuthResult ret)
   { 
       UE_LOG(LogTemp, Warning, TEXT("MethodID: %d"), ret.MethodId);
   }

2. 调用 AutoLogin 接口自动登录。

   Unity

   INTLAPI.AutoLogin();

   Unreal Engine

   UINTLSDKAPI::AutoLogin();

3. 在自动登录失败时调用 Login 接口使玩家手动登录。

   Unity

   INTLAPI.Login(INTLChannel.Apple); 

   Unreal Engine

   UINTLSDKAPI::Login(EINTLLoginChannel::kChannelApple); 

4. 与游戏后台同步客户端身份验证状态，等待最终验证结果。

[可选] 设置 email 权限

注意

Apple 获取玩家邮箱需要玩家授权，如果玩家拒绝授权将无法获取到玩家邮箱，详见 Login 接口传入 email 和 fullName。

要在 Apple 登录时获取玩家邮箱需先设置对应权限，开启后将在 AuthResult 的 ChannelInfo 中返回 email。

• 基于合规考虑，可针对特定来源对返回的 email 做 mask 处理，如有需求请联系 Player Network 助手 打开。
• 可在后台流水日志中上报 hash 后的 base64(sha256(email))，如有需求请联系 Player Network 助手 打开。
• 可用于验证玩家信息或绑定列表是否包含 email 信息，如有需求请联系 Player Network 助手 打开。

1. 调用 Login 接口时，需要在 permissions 参数中添加 email 权限。

2. 在 Player Network 控制台 开启 email 返回功能，将 return_email 设置为 YES，详细步骤请参见 第三方渠道配置。

步骤3：验收登录功能

在 Player Network SDK 日志中搜索关键字 "AuthResult" 确认渠道名称和 OpenID 是否正确返回。如果正确，则表明集成配置成功，登录功能已成功添加。

如果接入过程中遇到问题，请参见 常见问题。