将 UDP 与其他服务结合使用

UDP 构建中的 Google Play 游戏服务

概述

• 应用程序的包名称
• 为该应用程序签名所使用的证书

为 UDP 构建配置 Google Play 游戏服务

1. 在 Google Play 管理中心中，转到目标应用。
2. 转到Play 游戏服务 (Play Games Services) > 设置和管理 (Setup and management) > 配置 (Configuration)。
   • 如果您的 Google Play 游戏实施了 Google Play 游戏服务，则您的游戏将已链接到 Google Play 游戏服务项目。在这种情况下：
     1. 选择使用现有的 Play 游戏服务项目 (Use an existing Play Games Services project)。
     2. 选择您的游戏项目并选择使用 (Use)。
     3. 按照将 UDP 应用链接到您的游戏服务中的步骤操作。
   • 如果您的 Google Play 游戏未实施 Google Play 游戏服务：
     1. 在 Play 游戏服务 (Play Games Services) 设置页面中，选择是，我的游戏已经使用了 Google API (Yes, my game already uses Google APIs) 或者否，我的游戏不使用 Google API (No, my game doesn’t use Google APIs)。
     2. 按照创建和链接 Google Play 游戏服务项目中的步骤操作。

创建和链接 Google Play 游戏服务项目

1. 选择一个云项目。
2. 选择使用 (Use) 以创建新的 Play 游戏服务项目并将其链接到您现有的云项目。

1. 输入游戏名称。
2. 选择创建 (Create) 以创建新的 Play 游戏服务项目并将其链接到新的云项目。

1. 选择配置 OAuth 同意屏幕 (Configure OAuth consent screen)。
2. 在 Play 游戏服务 (Play Games Services) 配置页面中，选择刷新 (Refresh) 。
   现在已启用添加凭据 (Add credential) 选项。
3. 选择添加凭据 (Add credential)。
   这会打开添加凭据 (Add credential) 页面。
4. 在添加凭据 (Add credential) 页面中：
   1. 选择 Android 作为类型 。
   2. 将启用反盗版 (Enable anti-piracy) 设置为关闭 (Off)。这允许用户访问您的游戏，前提是用户安装自 Google Play 以外的其他应用商店。
   3. 在授权 (Authorization) 部分，选择创建 OAuth 客户端 (Create OAuth client)。这会打开一个弹出窗口。
   4. 选择创建 OAuth 客户端 ID (Create OAuth Client ID) 并使用弹出窗口中的详细信息来完成表单。

将 UDP 应用链接到您的游戏服务

1. 在 Google Play 管理中心中，选择 Play 游戏服务 (Play Games Services) > 设置和管理 (Setup and management) > 配置 (Configuration)。
   1. 在Play 游戏服务 (Play Games Services) 配置页面中，选择添加凭据 (Add credential)。
2. 在添加凭据 (Add credential) 页面中：
   1. 选择 Android。
   2. 将启用反盗版 (Enable anti-piracy) 设置为关闭 (Off)。这允许用户访问您的游戏，前提是用户安装自 Google Play 以外的其他应用商店。
   3. 在授权 (Authorization) 部分，选择创建 OAuth 客户端 (Create OAuth client)。这会打开一个弹出窗口。
   4. 选择创建 OAuth 客户端 ID (Create OAuth Client ID) 并使用弹出窗口中的详细信息来完成表单。
3. 在创建 OAuth 客户端 ID (Create OAuth client ID ) 表单中，输入所需的详细信息，为您的 UDP 构建之一创建条目。
   1. 在名称 (Name) 字段中，以相应的商店命名构建，例如“Samsung version”。
   2. 在包名称 (Package name) 字段中，指定通过 UDP 控制台向相应商店注册的构建的包名称。
      特定于商店的包名称显示在 UDP 控制台中：
      1. 转到我的游戏 (My Games) > 发布 (Publish) 选项卡。
      2. 选择相应商店的**高级 (Advanced)**设置。
         包名称显示在基本信息 (Basic Information) 部分中。
   3. 在证书字段中，使用对应 UDP 商店所使用的证书。在重新打包操作完成后，UDP 会使用新证书对应用程序进行签名。
      特定于商店的证书显示在 UDP 控制台中：
      1. 转到我的游戏 (My Games) > 发布 (Publish) 选项卡。
      2. 选择相应商店的**高级 (Advanced)**设置。
         证书显示在基本信息 (Basic Information) 部分中。
         注意：您还可以下载 APK 证书并通过以下命令获取指纹信息：

         openssl x509 -in [downloaded-pem-filepath] -fingerprint -noout

      3. 将 SHA-1 从 UDP 控制台复制到证书字段中。
4. 完成表格后，选择创建 (Create) 并返回 Google Play 管理中心。
5. 选择刷新 OAuth 客户端 (Refresh OAuth clients)。
6. 选择您的新 OAuth 客户端。
   1. 选择保存更改 (Save changes) 以保存凭据。
7. 对要链接到 Google Play 应用程序的每个特定于商店的 UDP 构建重复上述步骤。

将 Build Automation 与 UDP 结合使用

• 将 APK 上传到 Build Automation，然后从那里部署到 UDP
• 使用 Build Automation 构建游戏，然后从那里部署到 UDP

通过 Build Automation 将构建推送到 UDP 控制台

在编辑器中使用 Build Automation 将游戏部署到 UDP

1. 在项目设置 (Project Settings) 窗口的 Build Automation 选项卡中，如果先前从未上传过任何构建版本，请选择上传构建 (Upload Build)。
2. 在FILE 中：
   • 选择 UDP 构建版本的 APK
   • 在 LABEL 中输入有用的标签
   • 将平台 (PLATFORM) 字段设置为 Android。
3. 选择 UPLOAD，然后等待完成上传过程。
4. 在项目设置 (Project Settings) 窗口的 Build Automation 选项卡中，根据构建的历史 (History) 时间轴找到所需的构建版本，然后选择 推送到 Unity Distribution Portal (Push to Unity Distribution Portal)。
   1. 确认想要推送，然后确认操作完成。

使用 Unity Dashboard 将游戏部署到 UDP

1. 在 Unity 开发者控制面板 (Unity Developer Dashboard) 中，导航到项目的 Build Automation > 历史 (History)。
2. 选择 上传 (Upload)，然后选择 APK 文件。
3. 在平台 (Platform) 字段中，选择 Android。
4. 选择上传 (Upload)。
5. 选择构建版本旁边的更多 (More) 菜单以展开下拉菜单。
6. 选择推送到 Unity Distribution Portal (Push to Unity Distribution Portal)。

通过 Build Automation 进行构建和部署

1. 选择管理构建目标 (Manage Build Targets) > 添加新的构建目标 (Add new build target)
2. 在目标设置 (TARGET SETUP) 窗口中，将平台 (PLATFORM) 字段设置为 Android 并输入有用的目标标签 (TARGET LABEL)。
3. 选择下一步 (Next)：保存 (Save)。
4. 选择启动 Build Automation (Start Build Automation)，然后选择刚才创建的目标构建。

服务互操作性

工作原理

udp.json

udpStore

定位 udp.json

udp.json

Application.PersistentDataPath + '/Unity' + /Application.CloudProjectID + /udp/udp.json

• Application.PersistentDataPath

  是游戏的持久数据路径

• Application.CloudProjectID

  是游戏的 Unity 项目 ID

udp.json

path/storage/emulated/0/Android/data/com.mystudio.mygame/files/Unity/c83d2de2-de74-4b75-83fc-ade948bda064/udp/udp.json

• Application.PersistentDataPath

  =

  path/storage/emulated/0/Android/data/com.mystudio.mygame

• Application.CloudProjectID

  =

  c83d2de2-de74-4b75-83fc-ade948bda064

读取 udp.json

udp.json

{"key":"UDP","udpStore":"StoreName","udpClientId":"value_of_udpClientId","CloudProjectId":"value_of_CloudProjectId"}

udpStore

udp.json

{"key":"UDP","udpStore":"Huawei","udpClientId":"icjaB7wmu_q7AOjrSLH8yw","cloudProjectId":"bc2be074-09f3-450f-8e98-a0f79c9746f7"}

JSONUtility.FromJsonOverwrite

udpStore 值

udpStore

将 udpStore 与 Remote Config 一起使用

udpStore

1. 下载并安装 UDP 包。
2. 下载并安装 Unity Remote Config 包。请参阅 Remote Config 文档。
3. 创建一个 AppAttributes 结构，其中至少包含参数“udpStore”：

   public struct AppAttributes{  public string udpStore;}

4. 在游戏代码中，实现 Remote Config ConfigManager.FetchConfigs 调用。
5. 当调用 FetchConfigs 时，创建一个AppAttributes 结构的新实例，从以下位置读取 UDP 商店数据文件：Application.PersistentDataPath + '/Unity' + /Application.CloudProjectId + /udp/udp.json 使用 JSONUtility.FromJsonOverwrite 可将文件内容作为文本资源读取。

   {    string udpFilePath = System.IO.Path.Combine(Application.persistentDataPath, "Unity", Application.cloudProjectId, "udp", "udp.json");    string udpFileContents = System.IO.File.ReadAllText(udpFilePath);    var appAttr = JsonUtility.FromJson<AppAttributes>(udpFileContents);    Unity.RemoteConfig.ConfigManager.FetchCompleted += ConfigManager_FetchCompleted;    Unity.RemoteConfig.ConfigManager.FetchConfigs(null, appAttr);}

6. 确保在 ConfigManager.FetchConfigs 中使用 AppAttributes 结构。
7. 打开 Remote Config 设置（服务 (Services) > Remote Config > 配置 (Configure))，然后创建需要根据 UDP 商店而改变的参数。
8. 设置好参数并插入到游戏代码中后，请在 Remote Config 窗口中为每个商店创建一个规则。
9. 在每个规则的条件中，放入：app.udpStore == "[storeName]"
   • 请参阅 udpStore 的值

     

10. 要启用相应的设置，请在 Remote Config 设置的左面板上选中规则名称旁边的复选框。
11. 针对设备构建应用程序，并确保正确应用规则，然后发布。

使用 Unity IAP 实现用于 UDP 的 IAP 商品

• 初始化 UDP
• 查询商店的 IAP 商品库存
• 请求购买某个商品
• 消耗所购买的商品

查询 IAP 库存

使用 Unity IAP（代码实现）

获取编辑器中定义的 IAP 商品

queryInventory

ProductCatalog.LoadDefaultCatalog()

var catalog = ProductCatalog.LoadDefaultCatalog();foreach (var product in catalog.allValidProducts){   if (product.allStoreIDs.Count > 0)   {       var ids = new IDs();       foreach (var storeID in product.allStoreIDs)       {           ids.Add(storeID.id, storeID.store);       }       builder.AddProduct(product.id, product.type, ids);   }   else   {       builder.AddProduct(product.id, product.type);   }}

从 UDP 控制台获取 IAP 商品信息

queryInventory

builder.AddProduct(product.id, product.type, new IDs{})

productInfo.Value.Price

从 UDP 控制台获取 IAP 目录

使用 Unity IAP 包填充 IAP 目录

1. 在 Unity 编辑器中，选择服务 (Services) > Unity IAP > IAP 目录 (IAP Catalog)。
2. 选择添加产品 (Add Product)，然后输入每个 IAP 商品的详细信息。
   1. 在 Unity Distribution Portal 配置 (Unity Distribution Portal Configuration) 下添加 IAP 商品的价格。

      

3. 要将 IAP 商品保存到 UDP 控制台，请选择同步到 UDP (Sync to UDP)。对所创建的每个 IAP 商品执行此操作。