SDK 的所有配置
note
手动修改 INTLConfig.ini 配置时,请联系 Player Network 助手确认内容变更是否符合预期,详见 SDK Config 须知。
INTLConfig.ini 目录
INTLConfig.ini 在工程中的路径为:
- Unity
- Unreal Engine
| 1.17.00 | 1.16.05 |
|---|---|
INTLSDK/Scripts/INTLConfig/Editor/Resources/INTLConfig.ini | Android: /Plugins/Android/assets/INTLConfig.iniiOS: /Plugins/iOS/INTLSDK/INTLCore/INTLSDK.bundle/INTLConfig.iniWindows, PS5: /Plugins/x86_64/INTLConfig.ini Nintendo: /Plugins/Switch/INTLConfig.ini |
| 1.17.00 | 1.16.05 |
|---|---|
INTLSDK/Source/INTLConfig/Configs/Resources/INTLConfig.ini | Android: INTLSDKPlugin/Source/INTLSDKPlugin/INTLSDK/Android/assets/INTLConfig.ini iOS: INTLSDKPlugin/Source/INTLSDKPlugin/INTLSDK/iOS/INTLCore/INTLSDK.bundle/INTLConfig.ini Windows, PS5: INTLSDKPlugin/Source/INTLSDKPlugin/INTLSDK/resources/INTLConfig.ini Nintendo: INTLSDKPlugin/Source/INTLSDKPlugin/INTLSDK/Switch/INTLConfig.ini |
基础配置
- 必填 = 使用功能时必须填写
- 选填 = 使用功能时可省略不填并使用默认值
SDK 环境
| 字段 | 说明 | 备注 |
|---|---|---|
| INTL_URL | Player Network SDK 后台服务的 URL,根据不同的环境配置。 更多信息,请参见 获取部署集群信息。 | 必填 |
| GAME_ID | Player Network 游戏唯一标识,Player Network 控制台分配的 GAME_ID。 | 必填 |
| SDK_KEY | 网络通信签名,Player Network 控制台分配的 SDK_KEY。 | 必填 |
| LIFECYCLE | Android 插件生命周期监听 插件要求进行生命周期监听的,需要添加该配置。 例如, LIFECYCLE = Adjust,Facebook,Google,Twitter,AppsFlyer。 | 必填 |
| ANDROID_LOCAL_NOTIFICATION_ENABLE | Android 本地推送开关 默认:关闭 | 选填 |
| DEBUG_CHANNEL | 第三方渠道的 debug 模式,只有当 LOG_LEVEL <= 1 时才生效。不同渠道可以用 (,) 隔开。 例如, DEBUG_CHANNEL = Adjust,AppsFlyer,Firebase。 | 选填 |
| INTL_WEBVIEW_COMMON_URL | 判断 WebView 的域名是否已设置,将统一使用这个域名后面拼接对应的网页,设置此属性需要保证调用相关的 WebView 页面已配置好。 | 选填 |
| SHOW_TEST_TOAST | 显示测试环境 toast 弹窗 0:隐藏,1:显示 默认值:1 | 选填 |
| CONSOLE_STORE_CHANNEL | 主机平台商店渠道标识符,用于数据上报后在数据分析时区分不同的商店渠道。 业务可自行在 INTLConfig.ini 文件中配置用于区分当前平台的数值。如未配置,则默认上报以下值: Switch:1001 PS4:1002 PS5:1003 Xbox One:1004 Xbox Series X|S:1005 | 选填 |
| WINDOWS_STORE_CHANNEL | Windows 商店渠道标识符,用于数据分析时的数据上报。 可以选填业务方想要的值,在 INTLConfig.ini 文件中配置。默认值:100 | 选填 |
| INTL_PACKAGE_NAME | Windows/PS5/XSX/Switch 平台的包名,用于云控和 Player Network 控制台配置的拉取。 可以选填业务方想要的值,在 INTLConfig.ini 文件中配置,需要与 Player Network 控制台 云控和相关配置配合使用。 | 选填 |
| SHUTDOWN_CHANNELS_WINDOWS | 当前仅支持 Steam 和 Epic 平台。 在调用 Shutdown 接口时,会关闭对应渠道的接口并释放资源。 | 选填 |
Player Network SDK 日志
| 字段 | 说明 | 备注 |
|---|---|---|
| LOG_LEVEL | 日志级别 0:调试 1:信息 2:警告 3:错误 默认:3 | 选填 |
| LOG_ENCRYPT_ENABLE | 是否需要加密日志 0:关闭 1:开启 默认:1 | 选填 |
| LOG_COMPRESS_ENABLE | 是否输出落地日志 0:关闭 1:开启 默认:0 | 选填 |
| LOG_CONSOLE_OUTPUT_ENABLE | 是否输出 console 日志 0:关闭 1:开启 默认:0 | 选填 |
| LOG_FILE_OUTPUT_ENABLE | 是否输出日志文件 0:关闭 1:开启 默认:0 | 选填 |
| LOG_MAX_FILE_SIZE | 最大日志文件大小 单位:字节 默认:2x1024x1024(2 MB) | 选填 |
| LOG_FILE_EXCESS_ACTION | 文件超过最大大小后的行为 0:删除并重写 1:不再写入 默认:0 | 选填 |
| LOG_AUTO_DELETE_FILE_ENABLE | 自动清除过期的日志文件 0:关闭 1:开启 默认:1 | 选填 |
渠道配置-登录
Player Network SDK 登录
| 字段 | 说明 | 备注 |
|---|---|---|
| LOGIN_NETWORK_ERROR_CLEAR_AUTH_RESULT_ENABLE | 登录时网络出错,是否清空本地登录态 默认:1,清空本地登录态 | 选填 |
| AUTH_OVERTIME | V1.16.02 后不再生效,请参见 SDK_AUTH_OVERTIME 和 WEB_AUTH_OVERTIME。 登录超时时间 单位:秒 默认:30 | 选填 |
| SDK_AUTH_OVERTIME | v1.16.02 后生效 第三方渠道应用登录超时间隔。 登录超时设置避免玩家跳转到第三方应用后不返回游戏。由于网页登通常需要输入账号密码,通过第三方应用登录所需时间通常少于通过网页登录所需的时间。因此第三方应用登录和网页登录有两种不同的超时配置。 单位:秒 默认:45 | 选填 |
| WEB_AUTH_OVERTIME | v1.16.02后生效 网页登录超时时间 登录超时设置避免玩家跳转到第三方网站后不返回游戏。 由于网页登通常需要输入账号密码,通过第三方应用登录所需时间通常少于通过网页登录所需的时间。因此第三方应用登录和网页登录有两种不同的超时配置。 单位:秒 默认值:45 | 选填 |
| HTTP_TIMEOUT | 网络请求超时时间 单位:秒 默认:15 | 选填 |
| REFRESH_INTERVAL | PS5 登录状态自动刷新间隔 因为 PS5 令牌在短时间内过期,为了确保令牌在游戏中的有效性,SDK 自动刷新令牌的有效性由 REFRESH_INTERVAL 定义的间隔。 单位:秒 默认值:300 (5分钟) | 选填 |
| KEYCHAIN_ENABLE | iOS 设备 ID 是否开启 Keychain 存储 默认:1,开启 | 选填 |
| AUTOLOGIN_NOT_THROUGH_PLUGIN_CHANNEL | 在自动登录时,是否对设置的渠道不调用插件内的自动登录功能 不同渠道可以用 (,) 隔开 默认留空,对所有渠道开启。 | 选填 |
| AUTO_LOGIN_REINSTALL_ENABLE | v1.26.00 后生效 支持卸载重装游戏后自动登录,该选项开启时,SDK 会自动保存加密后的登录态到 Android 的 BlockStore 或 iOS 的 KeyChain 中,仅支持 Android/iOS 系统。 Android 系统依赖于 Google 服务框架,iOS 无特殊依赖。 默认:0,关闭;设置为1开启 | 选填 |
| MSDKV5_AUTH_ADAPT_ENABLE | 是否自动转换 MSDK 登录态为 Player Network SDK 登录态 默认:0,不转换 | 选填 |
| ITOPID_GUEST_LOGIN_ENABLE | 是否开启从 iTOP 迁移过来游客登录 默认:0,不开启 | 选填 |
| ITOP_GAME_ID | 配置迁移的 iTOP Game ID 在不开启 ITOPID_GUEST_LOGIN_ENABLE时,默认留空。 | 选填 |
LEVEL INFINITE PASS
| 字段 | 说明 | 备注 |
|---|---|---|
| ACCOUNT_SDK_KEY | Player Network 控制台分配的 ACCOUNT_SDK_KEY | 必填 |
| ACCOUNT_APP_ID | Player Network 控制台分配的 ACCOUNT_APP_ID | 必填 |
| CUSTOM_ACCOUNT_CHANNEL_ID | 自建账号渠道 ID | 从自建账号升级为 LI PASS 时必填 |
| ACCOUNT_THIRD_CHANNEL_ANDROID | Android 平台的第三方登录渠道 在登录界面和账号中心中显示第三方登录渠道。 示例: ACCOUNT_THIRD_CHANNEL_ANDROID = Facebook,Google | 必填 |
| ACCOUNT_THIRD_CHANNEL_IOS | iOS 平台的第三方登录渠道 在登录界面和账号中心中显示第三方登录渠道。 示例: ACCOUNT_THIRD_CHANNEL_IOS = Facebook,Apple | 必填 |
| ACCOUNT_THIRD_CHANNEL_WINDOWS | Windows 平台的第三方登录渠道 在登录界面和账号中心中显示第三方登录渠道。 示例: ACCOUNT_THIRD_CHANNEL_WINDOWS = Facebook,Google | 必填 |
| GAME_TOS_URL | 游戏条款链接 | 必填 |
| GAME_PP_URL | 游戏隐私协议链接 | 必填 |
| ACCOUNT_FLOW_SWITCH | 控制 LI PASS 各个部分 UI 的开关,此开关遵循位运算规则 更多信息,请参见表格下的 ACCOUNT_FLOW_SWITCH 部分。 默认值:0,所有功能正常开放。 | 选填 |
| LEVEL_INFINITE_ACTIVITY | LI PASS 界面的方向 LILandscape:横屏界面 LIPortrait:竖屏界面 默认:LILandscape | 选填 |
| LI_REGISTER_ENABLE | LI PASS 注册功能开关 0:关闭注册功能,验证码登录会自动注册 1:开启注册功能,显示注册按钮 默认值:1 | 选填 |
| ACCOUNT_THIRD_CHANNEL_BIND_MAX_COUNT | 允许绑定的第三方渠道数的上限。所有平台都共享相同账号的绑定数量 例如: ACCOUNT_THIRD_CHANNEL_BIND_MAX_COUNT = 3 表示最多可以绑定 3个渠道默认:11 | 选填 |
| ACCOUNT_THIRD_CHANNEL_UNBIND_BLACK_LIST | 禁止第三方渠道取消绑定。例如: ACCOUNT_THIRD_CHANNEL_UNBIND_BLACK_LIST = Facebook 表示不允许 Facebook 取消绑定 | 选填 |
| SAVE_EMAIL_ENABLE | 自动记录上次登录成功的邮箱功能开关 0:关闭功能,不会记录,下次打开登录界面也不会自动填充已记录的邮箱 1:开启功能,使用邮箱成功登录账号后会记录邮箱,下次打开登录界面时也会自动填充已记录的邮箱 默认值:0 | 选填 V1.07.00 新增 |
| SAVE_ACCOUNT_THIRD_CHANNEL_ANDROID_ENABLE | Android 平台记录第三方渠道登录顺序功能开关 0:关闭功能,登录界面第三方渠道按默认顺序排列 1:开启功能,登录界面第三方渠道按最近登录成功的顺序排列,上次登录成功的渠道有特殊标记 默认值:0 | 选填 V1.07.00 新增 |
| SAVE_ACCOUNT_THIRD_CHANNEL_IOS_ENABLE | iOS 平台记录第三方渠道登录顺序功能开关 0:关闭功能,登录界面第三方渠道按默认顺序排列 1:开启功能,登录界面第三方渠道按最近登录成功的顺序排列,上次登录成功的渠道有特殊标记 默认值:0 | 选填 V1.07.00 新增 |
| SAVE_ACCOUNT_THIRD_CHANNEL_WINDOWS_ENABLE | Windows 平台记录第三方渠道登录顺序功能开关 0:关闭功能,登录界面第三方渠道按默认顺序排列 1:开启功能,登录界面第三方渠道按最近登录成功的顺序排列,上次登录成功的渠道有特殊标记 默认值:0 | 选填 V1.07.00 新增 |
| GAME_TOS_VERSION | 服务条款版本 需更新条款并要求现有玩家同意更新条款,版本需升级。 默认:1 | 选填 |
| GAME_PP_VERSION | 隐私协议版本 如需更新条款并让存量玩家同意,更新版本。 默认:1 | 选填 |
{Channel} + _LOGIN_PERMISSION例如:FACEBOOK_LOGIN_PERMISSION | 指定渠道的登录权限 | 选填 |
{Channel} + _LOGIN_EXTRAJSON例如:FACEBOOK_LOGIN_EXTRAJSON | 指定渠道的登录 extra json | 选填 |
| LI_THIRD_DT_URL | 当通过第三方渠道登录时数据传输协议 URL 默认是 LI PASS 数据传输协议 URL | 选填 |
| LIPASS_PB_ENABLE | 0: 游戏不是 Proxima Beta 版本 1: 游戏是 Proxima Beta 版本 默认: 1 | 选填 |
| LI_DEFAULT_LOGIN_TYPE | 登录界面上的默认登录类型 1: 验证码登录 2: 密码登录 默认: 1 | 选填 |
| SHOW_AS_MARKETING_MODULE | 是否在账号中心显示 个人中心 页签 0:关闭 1:开启 默认值:1 | 选填 V1.26.00 新增 |
| SHOW_ACTIVE_POINT_EXCHANGE | 是否显示 金币 和 每日签到 模块 0:关闭 1:开启 默认值:1 | 选填 V1.26.00 新增 |
| PASSKEY_ENABLE | 此配置项用于设置是否启用通行密钥登录 0:关闭 1:开启 默认值:1 | 可选 V1.27.00 新增 |
ACCOUNT_FLOW_SWITCH
开关遵循位运算规则。十进制值 0,也就是二进制值 000000,表示所有的 UI 功能都正常开放。
| 匹配顺序 | 十进制值 | 说明 |
|---|---|---|
| 1 | 1 | 账号中心的第三方渠道绑定区域 |
| 2 | 2 | 登录界面和账号中心的修改密码按钮,以及登录界面的密码登录界面 |
| 3 | 4 | 第三方渠道解绑按钮 |
| 4 | 8 | 登录界面的第三方渠道登录按钮 |
| 5 | 16 | 所有弹框,包括地区选择,同意条款,和未成年认证流程 |
| 6 | 32 | 手机账号绑定按钮 |
ACCOUNT FLOW SWITCH 计算规则为:把需要隐藏的 UI 功能对应的十进制值进行相加。
例如,13(1 + 4 + 8 = 13)表示:
- 隐藏账号中心的第三方渠道绑定区域
- 隐藏所有第三方账号的解绑按钮
- 隐藏登录界面的第三方渠道登录按钮
- 其他功能皆正常开放
caution
游戏上线前,在 INTLConfig.ini 中添加 LI PASS 登录域名的配置到正式环境。在测试阶段无需添加此配置。
在 LI PASS V1.16 或之后的版本,此配置项为选填。
ACCOUNT_URL=https://li-sg.intlgame.com
Apple 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| INTL_APPLE_WEB_APP_ID | Apple 渠道的 APPLICATION ID | Android、Windows 必填 |
更多详情,请参见 配置 Apple 登录。
Discord 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| DISCORD_APP_ID | Discord App ID | 必填 |
| DISCORD_REDIRECT_URL | 开发者平台配置的 redirect URL | 必填 |
| DISCORD_UNIVERSAL_LINK_IOS | 在 Discord 开发者平台上设置的 Universal link,iOS 平台使用 | 必填 |
| DISCORD_LOGIN_USING_WEB | 1:使用网页登录 0:使用原 DiscordConnect SDK 登录 默认:0 | 选填 |
| DISCORD_CONFIG_WEB_URL | 用于游戏自定 Discord 网页登录的 URL (与 Windows 逻辑相同) | 选填 |
更多信息,请参见 配置 Discord 登录。
Epic 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| EPIC_PRODUCT_NAME | 产品名称 | 必填 |
| EPIC_PRODUCT_VERSION | 产品版本 | 必填 |
| EPIC_PRODUCT_ID | 产品 ID | 必填 |
| EPIC_SANDBOX_ID | 沙箱 ID | 必填 |
| EPIC_DEPLOYMENT_ID | 发布 ID | 必填 |
| EPIC_CLIENT_ID | 客户端 ID | 必填 |
| EPIC_CLIENT_SECRET | 客户端密钥 | 必填 |
更多信息,请参见 配置 Epic 登录。
Facebook 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| FACEBOOK_APP_ID | Facebook 渠道 的 app ID | 必填 |
| FACEBOOK_DISPLAYNAME | 应用在 Facebook 渠道显示的名称 例如:INTL Sample 注意必须和管理端保持一致,否则 iOS 会出错 | 必填 |
| FACEBOOK_WEBVIEW_LOGIN_ENABLE | Windows 是否使用 WebView 登录 默认:1 0:Windows 使用系统浏览器登录 1:Windows 使用 WebView 登录 | 选填 |
| FACEBOOK_CLIENT_REDIRECT_URL | 在 Windows 系统浏览器登录后会将网页跳转到指示的网站 默认:https://www.levelinfinite.com/ | 选填 |
更多信息,请参见 配置 Facebook 登录。
Google 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| GOOGLE_CLIENT_KEY_ANDROID | Google 渠道 的 Android Web Client key | 必填 |
| GOOGLE_CLIENT_KEY_IOS | Google 渠道 的 iOS Client key | 必填 |
| GOOGLE_LOGOUT_NEED_CONNECT | Google 非 connect 状态登出时,配置是否执行 connect 后再登出 默认:0(不执行) | 选填 |
| GOOGLE_EVERY_LOGIN_CHOICE_USER | 登录前是否执行插件登出 默认:0(不登出) | 选填(仅支持 Android) |
| GOOGLE_WEBVIEW_LOGIN_ENABLE | Windows 是否使用 WebView 登录 默认:0 0:Windows 使用系统浏览器登录 1:Windows 使用 WebView 登录 | 选填 |
| GOOGLE_CLIENT_REDIRECT_URL | 在 Windows 系统浏览器登录后会将网页跳转到指示的网站 默认:https://www.levelinfinite.com/ | 选填 |
更多信息,请参见 配置 Google 登录。
LINE 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| LINE_CHANNEL_ID | 在 LINE 开发者平台上申请的 ChannelID | 必填 |
| LINE_CHECK_SDK_VERSION_ENABLE | 用于校验运行设备的 Android 系统版本 如果设备系统版本在 Android 4.2 以下时,调用 LINE 渠道相关接口,会返回不支持 默认:开启 如果想关闭可以设置为 0 | 选填 |
更多信息,请参见 配置 LINE 登录。
PS5 渠道(Unreal Engine)
| 字段 | 说明 | 备注 |
|---|---|---|
| PS5_CLIENT_ID | PS5 客户端 ID | 必填 |
| INTL_PS5_DUID_ENABLE | 是否启用 DUID 0: 禁用 1: 启用 DUID 默认: 0 | 选填 |
更多详情,请参见 配置 PS5。
QQ 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| QQ_APP_ID | QQ 渠道的 app ID | 必填 |
更多信息,请参见 配置 QQ 登录。
Steam 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| STEAM_APPID | Steam App ID | 必填 |
| STEAM_AVATAR_RAW_RGBA_ENABLE | 是否返回播放头像的原生 RGBA 数据 Steam 提供的头像是大的 RGBA 格式,SDK 支持将头像编码成 PNG 格式并返回游戏。 0:返回 PNG 格式的头像 1:返回 RGBA 格式的头像 默认值:0 | 选填 |
| STEAM_WEBVIEW_LOGIN_ENABLE | Windows 是否使用 WebView 登录 SDK 支持 Steam web 登录方式,当 Steam 未安装时,玩家可以通过 web 登录获取 Steam 信息。 0:Windows 使用 Steam 登录 1:Windows 使用 WebView 登录 默认值:0 | 选填 |
更多信息,请参见 配置 Steam 登录。
X 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| TWITTER_CONFIG_WEB_URL | X 网页登录 URL 发布正式环境时需要切换到正式环境 | 选填 SDK V1.16 新增字段,仅供需要另外配置 URL 的情况使用,一般情况无需配置 |
| TWITTER_CONSUMER_KEY | X 的 API key 默认为空 | 选填 使用 X 好友功能时必填 |
| TWITTER_CONSUMER_SECRET | X 的 Secret key 默认为空 | 选填 使用 X 好友功能时必填 |
| TWITTER_CONSUMER_USE_SDK | X 的 SDK 账号登录,通常使用 WebView 0:使用 WebView 登录 1:使用 SDK 登录,但 X 已宣布不再支持 SDK | 可选 默认值:0 |
更多信息,请参见 配置 X 登录。
VK 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| VK_APP_ID | VK 的 App ID | 必填 |
更多信息,请参见 配置 VK 登录。
WeChat 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| WECHAT_APP_ID | WeChat 渠道的 app ID | 必填 |
| WECHAT_APP_KEY | 在 WeChat 渠道开发者平台上申请的 WeChat app key | 必填 |
| WECHAT_AUTO_REFRESH_ENABLE | 从配置获取 token 是否要自动刷新 默认值:1,开启自动刷新 | 选填 |
| WECHAT_UNIVERSAL_LINK_IOS | 在 WeChat 开发者平台上设置的 UNIVERSAL_LINK,iOS 平台使用 | 必填 |
Xbox 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| INTL_XSX_PR_URL | XSX 平台使用 PXUID 鉴权登录需要配置的域名 默认值:https://demo.intlgame.com | 选填 SDK V1.29.00 新增字段 |
更多详情,请参见 配置 XSX。
游客渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| TRANSFER_CODE_LENGTH_VALIDATION | 验证密码长度 默认:1,需要验证 | 选填 |
渠道配置-分析
Player Network SDK 上报
| 字段 | 说明 | 备注 |
|---|---|---|
| REPORT_ENABLE | 是否开启上报 默认:1,开启 | 选填 |
| REPORT_COMPRESS_ENABLE | 是否需要压缩 默认:1,压缩 | 选填 |
| REPORT_KV_MAX_LOCAL_FILE_NUM | KV 日志的落地文件最大数量 默认:10 | 选填 |
| REPORT_KV_MAX_LOCAL_FILE_SIZE | KV 日志的落地文件大小 单位:字节 默认:262144 | 选填 |
| REPORT_KV_TIME_INTERVAL | KV 日志的上报时间间隔 单位:秒 默认:5 | 选填 |
| REPORT_BIN_ENABLE | 是否开启二进制日志的文件上报 默认:1,开启 | 选填 |
| REPORT_BIN_SEG_SIZE | 二进制日志的文件分片大小 单位:字节 默认:32768 | 选填 |
| REPORT_BIN_MAX_LOCAL_FILE_NUM | 二进制日志的落地文件最大数量 | 选填 |
| REPORT_BIN_MAX_LOCAL_FILE_SIZE | 二进制日志的最大文件大小 单位:字节 | 选填 |
| REPORT_BIN_TIME_INTERVAL | 二进制日志的上报时间间隔 单位:秒 默认:10 | 选填 |
| REPORT_SRC_ID | 默认数据上报的来源 ID 默认:1000 | 选填 |
| REPORT_LIFECYCLE_ENABLE | 是否随着生命周期变化上报 默认:1,开启,切换到前后台会触发上报请求 | 选填 |
| PING_TIMEOUT | 收集网络质量时 ping 的超时 单位:秒 默认:1 | 选填 |
| REPORT_DISABLE_COLLECT_METHOD | 禁止上报的 Method ID, 以逗号 (,) 隔开 默认为空(全部上报) 建议填 501,703,706,721,724,731,732,902 | 选填 |
| REPORT_DISABLE_COLLECT_EVENT_NAME | 禁用报告事件的名称,用逗号 (,) 隔开 默认值:sdk_update_start | 选填 |
| REPORT_UA_DATA_ENABLE | 当前仅支持 Windows 是否启用 UA 上报功能 0:禁用 1:启用 默认:1,启用 | 选填 |
| REPORT_UA_DATA_SHORT_CODE_FILTER | 当前仅支持 Windows 配置 UA 短码过滤列表 在列表中的短码会直接上报 (多个短码以英文字符 (,) 隔开) 默认:空字符串 | 选填 |
| SECURITY_FLAG | 是否开启 Android 端安全检查(包含检测 HOOK、插桩、签名等) 0:禁用 1:启用 默认:1,启用 | 选填 |
Player Network SDK 分析
| 字段 | 说明 | 备注 |
|---|---|---|
| ANALYTICS_CHANNEL_START_ENABLE | 是否开启 channel_start 事件上报,至 Adjust, AppsFlyer, Facebook, 和 Firebase0:禁用 1:启用 默认:1,启用 | 选填 |
| ANALYTICS_REPORT_CHANNEL | 数据上报的渠道INTL 是 Player Network SDK 的自有渠道 如果接入了 LI PASS, ANALYTICS_REPORT_CHANNEL 配置项必须要开启 INTL | 必填 |
| ANALYTICS_CRASH_CHANNEL | Crash 的上报渠道 | 必填 |
| ANALYTICS_AUTH_REPORT_ENABLE | 是否自动上报注册和登录事件 可以联系 [killuachen(陈聪聪)] 确认此配置 默认:1,开启(V1.18.00 及以前版本默认关闭) 初始配置之后,如有需要,建议通过优先级更高的 Player Network 控制台 来下发配置,可避免因修改 INTLConfig.ini 而需重新打包的必要。详情请参见 欧盟用户广告隐私功能。 | 选填 |
| ANALYTICS_FIREBASE_IS_DELAY | Firebase 是否延迟初始化,如果开关开启,则需要在启动方法中手动调用初始化方法 默认:0 | 选填 |
| ANALYTICS_CONSENT_ENABLE | Consent Mode 功能是否开启 0:不开启,1:开启 默认:1 | 选填 |
| ANALYTICS_CONSENT_CHANNEL | Consent Mode 功能生效的渠道 支持:Firebase 默认:Firebase | 选填 |
| ANALYTICS_CONSENT_REQUIRED_TYPE | Consent Mode 功能必须处理的权限类型 ad_storage:启用与广告相关的存储机制 analytics_storage:启用与分析相关的存储机制,例如设备标识符存储 ad_user_data:就在线广告目的发送用户数据征求用户意见 ad_personalization:设置有关个性化广告的用户同意情况 默认:ad_user_data,ad_personalization | 选填 |
| ANALYTICS_CONSENT_DEFAULT_CONFIG | Consent Mode 功能开启时各个权限的默认配置 0:拒绝,1:同意 默认:ad_storage:1,analytics_storage:1,ad_user_data:1,ad_personalization:1 | 选填 |
Adjust 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| ADJUST_OPEN_DEEPLINK_ENABLE | 是否开启 deep link 功能 默认:0,不开启 | 选填 |
| ADJUST_APP_TOKEN_ANDROID | Android app token | 必填 |
| ADJUST_INFO1_ANDROID | 可选的 Android 客户端特性值 默认: 不填,不进行配置 | 选填 |
| ADJUST_INFO2_ANDROID | 可选的 Android 客户端特性值 默认: 不填,不进行配置 | 选填 |
| ADJUST_INFO3_ANDROID | 可选的 Android 客户端特性值 默认: 不填,不进行配置 | 选填 |
| ADJUST_INFO4_ANDROID | 可选的 Android 客户端特性值 默认: 不填,不进行配置 | 选填 |
| ADJUST_APPSECRET_ANDROID | Android 应用秘钥开关 默认为空 | 要设置 Android 应用秘钥, 该选项必须设置数值 |
| ADJUST_REGISTER_EVENT_TOKEN_ANDROID | Android 注册事件的 token | 必填 |
| ADJUST_LOGIN_EVENT_TOKEN_ANDROID | Android 上报登录的 token | 必填 |
| ADJUST_URL_STRATEGY_ANDROID | Android 数据驻留的地区 默认: 不填,不进行配置 url_strategy_india:数据驻留的地区为印度 url_strategy_china: 数据驻留的地区为中国 | 选填 |
| ADJUST_SIGNATURE_VERSION_ANDROID | Android 签名版本,1 表示 v1 签名,2 表示 v2 签名。 默认:1 | 选填 |
| ADJUST_APP_TOKEN_IOS | iOS app token | 必填 |
| ADJUST_INFO1_IOS | 可选的 iOS 客户端特性值 默认: 不填,不进行配置 | 选填 |
| ADJUST_INFO2_IOS | 可选的 iOS 客户端特性值 默认: 不填,不进行配置 | 选填 |
| ADJUST_INFO3_IOS | 可选的 iOS 客户端特性值 默认: 不填,不进行配置 | 选填 |
| ADJUST_INFO4_IOS | 可选的 iOS 客户端特性值 默认: 不填,不进行配置 | 选填 |
| ADJUST_APPSECRET_IOS | iOS 应用秘钥开关 默认值:-1 | 要设置 iOS 应用秘钥, 该选项必须设置非 -1 数值 |
| ADJUST_REGISTER_EVENT_TOKEN_IOS | iOS 注册事件的 token | 必填 |
| ADJUST_LOGIN_EVENT_TOKEN_IOS | iOS 上报登录的 token | 必填 |
| ADJUST_URL_STRATEGY_IOS | iOS 数据驻留的地区 默认: 不填,不进行配置 ADJUrlStrategyIndia:数据驻留的地区为印度 ADJUrlStrategyChina: 数据驻留的地区为中国 ADJDataResidencyEU: 数据驻留的地区为欧盟 ADJDataResidencyTR: 数据驻留的地区为土耳其 ADJDataResidencyUS: 数据驻留的地区为美国 | 选填 |
| ADJUST_SIGNATURE_VERSION_IOS | iOS 签名版本,1 表示v1 签名,2表示v2 签名。 默认:1 | 选填 |
| ADJUST_SUB_DOMAIN | 配置 Adjust 上报中转服务器 默认: 不填,不进行配置 | 选填 |
| ADJUST_CHANNEL_START_EVENT_TOKEN_ANDROID | Android 自定义启动事件令牌 | 必填 |
| ADJUST_CHANNEL_START_EVENT_TOKEN_IOS | iOS 自定义启动事件令牌 | 必填 |
更多信息,请参见 Adjust 配置。
AppsFlyer 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| APPSFLYER_APP_ID_IOS | AppsFlyer 的 iOS 应用 ID | 必填 |
| APPSFLYER_APP_KEY_IOS | AppsFlyer 的 iOS 应用密钥 | 必填 |
| APPSFLYER_APP_KEY_ANDROID | AppsFlyer 的 Android app key | 必填 |
| FIREBASE_SENDER_ID | AppsFlyer 的 Firebase sender ID | 必填 |
| APPSFLYER_WAITFORATT_TIMEOUT | AppsFlyer 的系统追踪授权的监听时间 单位:秒,需要设置 int 值 默认:0 | 选填 |
| APPSFLYER_ADSUPPORT_AND_IAD_ENABLE | 是否启用 AppsFlyer 的 AdSupport 框架 和 iAD 框架,默认启用。 更多信息,可以参见 AppsFlyer 的启用 AdSupport 和 iAD 框架功能。 默认:1,启用 | 选填 |
| APPSFLYER_ANONYMIZE_USER_ENABLE | 是否启用 AppsFlyer 的 匿名化用户。 更多信息,可以参见 AppsFlyer SDK 的匿名化数据功能. 默认:0,不启用 | 选填 |
更多信息,请参见 AppsFlyer 配置。
TikTok 渠道
| 字段 | 说明 | 备注 |
|---|---|---|
| TIKTOK_EVENT_APPID | TikTok 的应用 ID | 必填 |
| TIKTOK_EVENT_TT_APPID | TikTok 的 TikTok 应用 ID | 必填 |
更多信息,请参见 TikTok 配置。
模块配置
Player Network SDK WebView
| 字段 | 说明 | 备注 |
|---|---|---|
| WEBVIEW_FULLSCREEN_ENABLE | 是否全屏 默认:0,禁用 | 选填 |
| WEBVIEW_PORTRAIT_HIDE_MENU_BAR_ENABLE | 当竖屏时,是否隐藏菜单栏 默认:0,不隐藏 | 选填 |
| WEBVIEW_LANDSCAPE_HIDE_MENU_BAR_ENABLE | 当横屏时,是否隐藏菜单栏 默认:0,不隐藏 | 选填 |
| WEBVIEW_SHARE_CHANNEL | JS 的分享渠道,支持 Facebook,LINE,System 当设置为 NONE 时,不显示分享按钮当此字段设置为任意值时,启用系统分享 默认:Facebook, Line, System | 选填 |
| WEBVIEW_URL_KEY_FILTER | 过滤 URL 中相关登录状态的关键字 不同字段可以用 (,) 隔开,例如 accesstoken,username无需过滤可以直接填 NONEAndroid 平台需要 OpenURL 接口 ExtraJson 里的 isSameProcessWebView=true默认为空 | 选填 |
| CONFIG_KEY_BACK_DISABLE | 是否禁用返回按钮,(只限 Android) 默认:0,不禁用 | 选填 |
| WEBVIEW_DEFAULT_WIDTH | Windows 登录 WebView 的宽度 单位:% | Windows 必填 |
| WEBVIEW_DEFAULT_HEIGHT | Windows 登录 WebView 的高度 单位:% | Windows 必填 |
| WEBVIEW_NAVIGATION_BUTTON_DISABLE | 是否禁用返回和系统浏览器按钮, (只限 Windows) 默认:0,不禁用 | Windows 必填 |
| WEBVIEW_UI_COLOR_THEME | WebView 风格的框架 (dark/light), (只限 Windows) 默认:dark | Windows 必填 |
| WEBVIEW_VIEWPORT_DPI | Webview 每英寸点数,设置浏览器的长宽, (只限 Windows) 默认:96 | Windows 必填 |
| WEBVIEW_ALWAYS_ON_TOPMOST_WINDOW | WebView 总是在最前面 (只限 Windows) 默认:1,总在前面 | Windows 选填 |
| WEBVIEW_ACCEPTED_LANGUAGE_LIST | 提供网页 WebView 支持的语言 (只限 Windows) 更多语言配置的信息,请参见 语言列表 默认:en-US,zh-CN,ja-JP,ko-KR | Windows 选填 |
| WEBVIEW_DYNAMIC_RESOLUTION_ENABLE | 当显示器分辨率改变时 Webview 是否调整大小。 默认:1,不调整大小。 | Windows 选填 |
| WEBVIEW_DPI_AWARENESS_ENABLE | 开启 DPI 感知模式 0:保持 DPI Unaware 1:开启系统 DPI 感知 默认:0 | Windows 选填 |
| WEBVIEW_CACHE_NAME | WebView 缓存目录 默认值:webview_cache | Windows 选填 |
| INTL_WEBVIEW2_ENABLE | 启用 Microsoft Edge WebView2,以在本地应用中嵌入网页内容,只限 Windows 默认值:1, 启用INTLWebView2; 0:启用INTLWebView 1:启用INTLWebView2 | Windows 选填 Player Network SDK V1.29.00及之前版本,该配置默认值为0 |
Player Network SDK 公告
| 字段 | 说明 | 备注 |
|---|---|---|
| NOTICE_INTERVAL | 时间间隔[1] 单位:秒 默认:300s (5 min) | 选填 |
[1]
在时间间隔内使用相同参数调用获取公告接口,会直接返回上次客户端缓存的数据,不会去后台拉取。
Player Network SDK 云控
| 字段 | 说明 | 备注 |
|---|---|---|
| PULL_REMOTE_CONFIG_SWITCH | 是否定时触发云控[1] 1:开启 0:关闭 默认:1,开启 | 选填 |
| REMOTE_CONFIG_INTERVAL | 云控触发间隔 单位:毫秒 默认:1,080,000 (18 min) | 选填 |
[1]
开启后,SDK 将会每隔固定时间触发一次云控,拉取最新配置并刷新缓存。
关闭后,SDK 只会在初始化、登录成功后拉取一次最新云控,如有新配置下发,需重新初始化或重新登录。