升级至 V1.18

SDK V1.18 已支持 iOS 的权限要求，在请求敏感权限时填写 使用说明。在请求权限时，系统会弹窗告知用户请求敏感权限的目的。此外，本次更新还简化了 Unreal Engine 版本 INTLConfig 插件中的 iOS information property list 文件，从而简化了配置过程。

完整的版本更新详情，请参见 V1.18 更新日志。

升级影响

若业务请求敏感权限但是不提供使用说明，则无法通过 Apple 的 App Review。因此，对于试图在 iOS 平台上发布的业务，有必要升级到此版本的 SDK 以便为 SDK 请求的敏感权限添加使用说明。

升级内容

Unity

为使用说明添加了以下键：

• NSPhotoLibraryUsageDescription
• NSCameraUsageDescription
• NSLocationWhenInUseUsageDescription
• NSPhotoLibraryAddUsageDescription
• NSMicrophoneUsageDescription
• NSUserTrackingUsageDescription

Unreal Engine

为使用说明添加了以下键：

• NSPhotoLibraryUsageDescription
• NSCameraUsageDescription
• NSLocationWhenInUseUsageDescription
• NSPhotoLibraryAddUsageDescription
• NSMicrophoneUsageDescription
• NSUserTrackingUsageDescription

iOS information property list 文件存放在 INTLSDK/Source/INTLConfig/Configs/iOS/Plist 目录中。每个 INTL{Plugin}.plist 都是各自 iOS Player Network SDK 插件的 Info.plist 配置文件。业务应根据插件配置修改这些文件中的值。

升级指引

警告

在修改默认的使用说明之前，请确保咨询法务以确保内容合规。如果默认的使用说明符合游戏访问敏感权限的目的，只需将 INTLSample 替换为对应的游戏名称即可。

Unity

1. 在 Assets/INTLSDK/Editor/XUPorter/Mods~/INTLCoreKit.projmods 文件中，将以下键值修改为实际展示的使用目的，或直接将 INTLSample 替换为对应的游戏名称。

   "NSPhotoLibraryUsageDescription"
   "NSCameraUsageDescription"
   "NSLocationWhenInUseUsageDescription"
   "NSPhotoLibraryAddUsageDescription"
   "NSMicrophoneUsageDescription"

2. 在 Assets/INTLSDK/Editor/XUPorter/Mods~/INTLADTrackingKit.projmods 文件中，将以下键值修改为实际展示的使用目的，或直接将 INTLSample 替换为对应的游戏名称。

   "NSUserTrackingUsageDescription"

Unreal Engine

1. 在 Plugins/INTLSDK/Source/INTLConfig/Configs/iOS/Plist/INTLCore.plist 文件中，将以下键值修改为实际展示的使用目的，或直接将 INTLSample 替换为对应的游戏名称。

   <key>NSPhotoLibraryUsageDescription</key>
   <key>NSCameraUsageDescription</key>
   <key>NSLocationWhenInUseUsageDescription</key>
   <key>NSPhotoLibraryAddUsageDescription</key>
   <key>NSMicrophoneUsageDescription</key>

2. 在 Plugins/INTLSDK/Source/INTLConfig/Configs/iOS/Plist/INTLADTracking.plist 文件中，将以下键值修改为实际展示的使用目的，或直接将 INTLSample 替换为对应的游戏名称。

   <key>NSUserTrackingUsageDescription</key>

3. 打开 Unreal Engine > Settings > Project Settings > Platforms > iOS > Extra Plist Data 并复制保存其配置。

4. 在 INTLSDK/Source/INTLConfig/Configs/iOS/Plist 目录下找到 INTL{Plugin}.plist 文件，并将其中的 {placeholder} 替换为前一步保存的配置。

   下图以 INTLFacebook.plist 示例，其中大括号中的值需要用实际配置替换。为方便 SDK 脚本可以自动合并所有插件的配置，需为每个插件添加对应的 INTL{Plugin}.plist 文件。

   

注意事项

在请求敏感权限时填写的使用说明需确保内容合规。