跳转至

配置信息

开始之前

  • 您必须[Install Soha SDK](Install-SDK.md)。
  • 您已经下载并安装了SohaGame提供的“.p12”和“.mobileprovision”文件。

配置Info.plist文件

使用包含应用程序数据的XML片段配置Info.plist文件。

右键单击Info.plist,然后选择 打开为 ▸ 源代码。

SDK 与服务配置

添加以下键以配置 SohaGame SDK 及其集成服务。

  1. 添加 SohaGameAppID、GameID。

    <key>SohaGameAppID</key>
    <string>SOHA-APP-ID</string>
    <key>GameID</key>
    <string>GAME-ID</string>
    
    将SOHA-APP-ID替换为SohaGame提供的应用程序ID
    将 GAME-ID 替换为 SohaGame 提供的 GameID(例如:SG388)

  2. 添加 Facebook 应用配置。

    <key>FacebookAppID</key>
    <string>FACEBOOK-APP-ID</string>
    <key>FacebookClientToken</key>
    <string>FACEBOOK-TOKEN</string>
    
    将FACEBOOK-APP-ID替换为SohaGame提供的FACEBOOK应用程序ID
    将FACEBOOK-TOKEN替换为SohaGame提供的FACEBOOK客户端令牌

  3. 添加LSApplicationQueriesSchemes。

    <key>LSApplicationQueriesSchemes</key>
    <array>
        <string>fbauth2</string>
        <string>fbapi</string>
        <string>fb-messenger-share-api</string>
    </array>
    

  4. 添加CFBundleURLTypes。

    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>GOOGLE-REVERSED-CLIENT-ID</string>
                <string>fb{FACEBOOK_APP_ID}</string>
                <string>sh{SOHA_APP_ID}</string>
            </array>
        </dict>
    </array>
    
    在值 GOOGLE-REVERSED-CLIENT-ID 中,将 GOOGLE-REVERSED-CLIENT-ID 替换为 SohaGame 提供的 Google 反向客户端 ID。
    在值 fb{FACEBOOK_APP_ID} 中,将 {FACEBOOK_APP_ID} 替换为 SohaGame 提供的 Facebook 应用 ID。保留 fb 前缀并删除花括号。例如,如果应用 ID 为 123456789,则使用 fb123456789。
    在值 sh{SOHA_APP_ID} 中,将 {SOHA_APP_ID} 替换为 SohaGame 提供的 Soha 应用 ID。保留 sh 前缀并删除花括号。例如,如果应用 ID 为 123456789,则使用 sh123456789。

  5. 添加 NSAdvertisingAttributionReportEndpoint。

    <key>NSAdvertisingAttributionReportEndpoint</key>
    <string>https://adjust-skadnetwork.com/</string>
    

权限用途说明

添加以下用途说明,向用户解释应用请求各项权限的原因。跟踪权限用于个性化广告,照片图库、麦克风和相机权限用于问题反馈功能。

  1. 添加 NSUserTrackingUsageDescription.

    <key>NSUserTrackingUsageDescription</key>
    <string>Mã nhận dạng này sẽ được sử dụng để phân phối quảng cáo được cá nhân hóa cho bạn.</string>
    

  2. 添加 NSPhotoLibraryUsageDescription.

    <key>NSPhotoLibraryUsageDescription</key>
    <string>Ứng dụng cần truy cập thư viện ảnh để bạn chọn ảnh minh họa lỗi, giúp bộ phận hỗ trợ hiểu rõ vấn đề bạn đang gặp.</string>
    

  3. 添加 NSMicrophoneUsageDescription.

    <key>NSMicrophoneUsageDescription</key>
    <string>Ứng dụng cần sử dụng micro để thu âm khi bạn quay video minh họa lỗi, giúp bộ phận hỗ trợ hiểu rõ vấn đề bạn đang gặp.</string>
    

  4. 添加 NSCameraUsageDescription.

    <key>NSCameraUsageDescription</key>
    <string>Ứng dụng cần sử dụng camera để bạn chụp ảnh hoặc quay video minh họa lỗi, giúp bộ phận hỗ trợ hiểu rõ vấn đề bạn đang gặp.</string>
    

添加 AdServices.framework

  1. 导航到 Build Phases 选项卡。
  2. 展开 Link Binary With Libraries 部分。
  3. 点击该部分左下角的 "+" 按钮。
  4. 在搜索栏中输入 AdServices,然后从列表中选择 AdServices.framework。
  5. 点击 Add。
  6. 添加完成后,在列表中找到 AdServices.framework,点击其旁边的 Status 列,将状态从 Required 更改为 Optional。

Adding AdServices.framework

添加 GoogleService-Info.plist 文件

  1. 下载 GoogleService-Info.plist 文件。该文件的下载链接可在 .xlsx 文件中找到。
  2. 将配置文件移动到 Xcode 项目的根目录。如果出现提示,请选择将配置文件添加到所有目标 (targets)。确保配置文件的名称未附加额外字符。

GoogleService-Info.plist file

配置签名

Bunlde ID和配置文件

捆绑包ID将由SohaGame提供,您需要配置正确的捆绑包ID和配置文件

Screenshot

  1. 选择游戏目标。
  2. 选择 Signing & Capabilities 选项卡。
  3. 填写正确的捆id。
  4. 选择与捆绑包id相对应的 .mobileprovision 文件

代码登录

1.在游戏目标中,选择 Build Settings 选项卡。 2.选择Signing ▸ Code Signing。 3.选择SohaGame为您提供的证书文件(.p12文件)。

Screenshot

配置功能

选择Signing & Capabilities选项卡。单击 + Capability 按钮,查找并添加以下功能
- In-App Purchase - Push Notifications - Sign in with Apple

配置 SceneDelegate

请按照SceneDelegate设置场景生命周期,并将登录 URL 回调转发给 SohaSDK。