用途:该技能是 CometChat Android UIKit v6 中 UIKitSettings.UIKitSettingsBuilder 的详细配置参考,用于初始化 CometChat SDK 时集中设置应用标识、区域、鉴权、在线状态订阅、通话能力与主机地址覆盖,适合需要深入配置初始化参数的 Android 开发者;基础初始化与登录建议改用 cometchat-android-v6-core,推送相关另见 cometchat-android-v6-push。
主要能力:必填项包括 setAppId(APP_ID) 与 setRegion("us" 或 "eu");开发环境可用 setAuthKey(AUTH_KEY),生产须用登录令牌替代;在线状态订阅提供 subscribePresenceForAllUsers、subscribePresenceForRoles(list)、subscribePresenceForFriends,另有 setRoles 直接覆盖角色列表,同一时间仅一种订阅类型生效,最后设置的生效,默认不订阅;setAutoEstablishSocketConnection(true) 控制 socket 自动连接,默认 true;setEnableCalling(true) 会在 Chat SDK 初始化成功后自动初始化 CometChatCalls SDK,默认 false,并可通过 setCallSettingsBuilder 传入自定义配置;overrideAdminHost 与 overrideClientHost 用于自托管部署的主机覆盖。
使用方式:用链式调用构建 settings 后传给 CometChatUIKit.init()。自定义通话需传入 CometChatCalls.SessionSettingsBuilder(该参数类型为 Any,内部会转型,传入 CallSettingsBuilder 会被静默存为 null),初始化后可用 CometChatUIKit.getSessionSettingsBuilder() 取回。初始化状态可用 CometChatUIKit.isSDKInitialized() 与 isCallsSDKInitialized() 分别检查。
限制:不要同时设置 AllUsers 与 Roles 订阅;生产环境不要使用 setAuthKey;启用通话需在 Gradle 中引入 CometChatCalls SDK 依赖;若 Calls 初始化失败,Chat SDK 仍会报告成功,需另行检查;主机覆盖仅用于本地部署,云托管场景不应使用。其他细节暂未提供。