跳到主要内容

获取设备信息(GetDeviceInfo)

AndroidiOSWindows
如果您使用的是 Unity 引擎,请参见 Unity SDK 的 GetDeviceInfo

获取当前设备的信息。

警告

如果通过 GetDeviceInfo 接口获取了 IDFA、XWID 或者 UAID 数据,需要高度关注以下事项。

IDFA:仅可用于在应用程序内投放和跟踪/归属广告。禁止对 IDFA 进行任何其它使用 (例如安全分析),同样禁止使用任何其它标识符进行广告。

XWID:

  • XWID 不能与 advertising ID 一起使用。
  • 限定使用的低风险场景:可用于跟踪具有相同签名密钥的应用程序之间的已登出用户偏好,并用于反欺诈目的(使用 Android ID 将信息范围限定至相同的应用程序签名密钥)。
  • 如果获取 XWID 做新增用途,需要明确的在业务的 ROP 表格中披露具体的使用场景,并通过业务侧合规评审。
  • 如果使用 XWID 做新增用途,需在隐私协议中披露与更新。

UAID:是三方 UA 平台生成的用于识别设备的标识符,需要合规团队评审通过后才能使用。

函数定义

UFUNCTION(BlueprintCallable, Category = "INTLSDKAPI")
static FString GetDeviceInfo(const FString extra_json);

入参说明

名称类型说明
extra_jsonFString额外参数 JSON 串

代码示例

FString deviceInfo=UINTLSDKAPI::GetDeviceInfo("");
Fstring extraJson = "{\"idfa\":1, \"xwid\":1, \"adjust_uaid\": 1, \"appsflyer_uaid\": 1, \"firebase_uaid\": 1, \"facebook_uaid\": 1}"; // IDFA(iOS 端)、XWID(三端都有)和 UAID 均为敏感数据
FString deviceInfo2=UINTLSDKAPI::GetDeviceInfo(extraJson);

返回结果

设备信息示例:

{"comm_c_xwid":"92be4a32a74afc497ba4653dfcb7df09ec4e5gW4762f","comm_c_os":2,"comm_c_os_version":"15.4","comm_c_app_version":"1.0(1)","comm_c_device_model":"iPhone13,2","comm_c_bundle_id":"com.intlgame.demo","comm_c_carrier_id":"46002","comm_c_ram_total":3662,"comm_c_rom_total":244017,"comm_c_screen_width":1170,"comm_c_screen_height":2532,"comm_c_network_type": 2,"comm_c_cpu_name":"Apple","comm_c_cpu_core":6,"comm_c_cpu_freq":0,"comm_c_gpu_name":"Apple","comm_c_language":"zh", "comm_c_adjust_uaid":"xxxxx", "comm_c_appsflyer_uaid":"xxxxx", "comm_c_firebase_uaid":"xxxxx", "comm_c_facebook_uaid":"xxxxx"}

返回参数的说明,请参见 Player Network SDK 数据上报公共字段