更新时间：2025-12-11 11:52:54
请您务必确保已经接入/升级至满足监管新规的最新版本创蓝闪验SDK（点击进入最新版SDK下载页）。| 功能区分 | 业务功能 | 功能介绍 | 个人信息类型及处理目的 | 配置方式 |
|---|---|---|---|---|
| 基本功能 | 一键认证 | 提供基于手机号码的账号登录服务 | 必要个人信息：
• 手机号码：用于提供手机号码一键登录能力。(Android & iOS & Harmony) • IP地址：用于锁定使用服务手机号，获取当前上网卡的预取号以及 token 信息。(Android & iOS & Harmony) 可选个人信息： • 设备硬件信息（包括设备型号、设备硬件制造商、设备屏幕分辨率）、操作系统信息（包括操作系统版本）：用于对不同设备做个性化适配，确保一键认证服务在不同设备上的兼容性。(Android & iOS & Harmony) • 网络信息（包括网络类型、运营商名称、网络状态、网络制式）：用于判断用户是否连接了移动网络，及部分场景下改变网络连接类型，从而实现在移动网络状态下的一键登录功能。(Android & iOS & Harmony) • SIM卡信息（包括SIM卡状态、subId）：用于判断当前流量SIM卡的状态是否准备就绪，及双卡双待手机是否切换流量卡。(Android & iOS & Harmony) | 可选信息配置详见“SDK 可选个人信息配置说明” |
| 拓展功能 | 日志服务 | 提供日志服务功能，用于统计各步骤成功率、失败率，及产生原因。 | • 设备硬件信息（包括设备型号、设备硬件制造商）、操作系统信息（包括操作系统版本）：用于分析不同设备一键登录的成功率、失败率，及成功或失败的原因，为不同设备兼容性适配提供依据。(Android & iOS & Harmony)
• 网络信息（包括网络类型、运营商名称、网络状态、网络制式）：用于分析取号过程中的网络条件，为查找一键登录成功或失败的原因提供依据。(Android & iOS & Harmony) |
Android端
开启、关闭示例： OneKeyLoginManager.getInstance().setFullReport(false); 参数说明： true ：开启；false：关闭；默认：true。 iOS端 开启、关闭示例： +(void)forbiddenFullLogReport:(BOOL)forbidden; 参数说明： YES：关闭；NO：开启；默认：NO； Harmony端 开启、关闭示例： static forbiddenFullLogReport(forbidden: boolean); 参数说明： true ：关闭；false：开启；默认：false。 |
| 安全风控 | 提供用户账号安全校验功能，提升用户账号安全 | • 设备标识符（包括iOS端IDFV、Android端OAID、Harmony端ODID）：用于生成脱敏的终端用户设备唯一性标识，防范安全风险。(Android & iOS & Harmony) |
Android端
开启、关闭示例： OneKeyLoginManager.getInstance().setSafetyRiskControl(false); 参数说明： true ：开启；false：关闭；默认：true。 iOS端 开启、关闭示例： +(void)forbiddenSafetyRiskControl:(BOOL)forbidden; 参数说明： YES：关闭；NO：开启；默认：NO； Harmony端 开启、关闭示例： static forbiddenSafetyRiskControl(forbidden: boolean); 参数说明： true ：关闭；false：开启；默认：false。 |
| 个人信息类型 | 个人信息采集目的 | 配置方式 |
|---|---|---|
| 设备硬件信息（包括设备型号、设备硬件制造商、设备屏幕分辨率）、操作系统信息（包括操作系统版本） | 用于对不同设备做个性化适配，确保一键认证服务在不同设备上的兼容性。 |
Android端 开启、关闭示例： OneKeyLoginManager.getInstance().setDeviceInfo(false); 参数说明： true ：开启；false：关闭；默认：true。 iOS端 开启、关闭示例： +(void)forbiddenDeviceInfo:(BOOL)forbidden; 参数说明： YES：关闭；NO：开启；默认：NO； Harmony端 开启、关闭示例： static forbiddenDeviceInfo(forbidden: boolean); 参数说明： true ：关闭；false：开启；默认：false。 |
| 网络信息（包括网络类型、运营商名称、网络状态、网络制式） | 用于判断用户是否连接了移动网络，及部分场景下改变网络连接类型，从而实现在移动网络状态下的一键登录功能。 |
Android端 开启、关闭示例： OneKeyLoginManager.getInstance().setNetworkInfo(false); 参数说明： true ：开启；false：关闭；默认：true。 iOS端 开启、关闭示例： +(void)forbiddenNetworkInfo:(BOOL)forbidden; 参数说明： YES：关闭；NO：开启；默认：NO； Harmony端 开启、关闭示例： static forbiddenNetworkInfo(forbidden: boolean); 参数说明： true ：关闭；false：开启；默认：false。 |
| SIM卡信息（包括SIM卡状态、subId） | 用于判断当前流量SIM卡的状态是否准备就绪，及双卡双待手机是否切换流量卡。 |
Android端 开启、关闭示例： OneKeyLoginManager.getInstance().setSimcardInfo(false); 参数说明： true ：开启；false：关闭；默认：true。 iOS端 开启、关闭示例： +(void)forbiddenSimcardInfo:(BOOL)forbidden; 参数说明： YES：关闭；NO：开启；默认：NO； Harmony端 开启、关闭示例： static forbiddenSimcardInfo(forbidden: boolean); 参数说明： true ：关闭；false：开启；默认：false。 |
| 平台 | 权限 | 使用场景 | 使用目的 | 申请时机 |
|---|---|---|---|---|
| Android | android.permission.INTERNET（必选） | 网络通信 | 允许应用程序联网，用于访问网关和认证服务器 | 调用sdk业务功能时申请 |
| android.permission.ACCESS_WIFI_STATE（必选） | 查看WiFi状态 | 获取WiFi状态，判断是开启WiFi等 | 调用功能接口的前置检查 | |
| android.permission.ACCESS_NETWORK_STATE（必选） | 查看网络状态 | 获取网络状态，判断是否开启数据、WiFi等 | 调用功能接口的前置检查 | |
| android.permission.CHANGE_NETWORK_STATE（必选） | 进行网络切换通信 | 允许程序改变网络连接状态，当用户未使用数据流量时，切换为数据流量，以获取用户手机号码 | WiFi和蜂窝网络双开且需要使用功能接口时申请 | |
| android.permission.CHANGE_WIFI_STATE（可选） | 进行网络切换通信 | 允许程序改变WiFi连接状态，当用户未使用数据流量时，切换为数据流量，以获取用户手机号码 | WiFi和蜂窝网络双开且需要使用功能接口时申请 | |
| IOS | 蜂窝网络权限（必选） | 获取用户手机号 | 用于一键获取您的手机号码 | 调用网关取号功能时申请 |
| Harmony | ohos.permission.INTERNET（必选） | 网络通信 | 允许应用程序联网，用于访问网关和认证服务器 | 调用sdk业务功能时申请 |
| ohos.permission.GET_NETWORK_INFO（必选） | 查看网络状态 | 获取网络状态，判断是否开启数据、WiFi等 | 调用功能接口的前置检查 | |
| ohos.permission.SET_NETWORK_INFO（必选） | 进行网络切换通信 | 允许程序改变网络连接状态，当用户未使用数据流量时，切换为数据流量，以获取用户手机号码 | Wi-Fi和蜂窝网络双开且需要使用功能接口时申请 |
复制成功public void init(Context context, String appId, InitListener initListener)
复制成功+(void)initWithAppId:(NSString *)appId complete:(nullable CLComplete)complete;
复制成功static async init(context: Context, appId: string): Promise<CLResult>