---
code: cocos2d-x_sdk_preset_properties
name: "预置属性"
wikiToken: KmHwwXrHiid7f3k7VkicDR22nic
parentWikiToken: AoyTwkwUniCkJsk1HnRcjV8vngh
updateTime: 1745310882000
sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d-x_sdk_preset_properties
---
# 预置属性

### 一、预置属性说明

<!-- unsupported block: 34 -->

各个平台采集的预置属性会有一定的差异，具体可以参考如下文档: Android平台 、 iOS平台  

**PC平台****预置****属性:**

**属性****名**

**中文名**

**属性类型**

**说明**

#ip

IP 地址

文本

用户的 IP 地址，AE 将以此获取用户的地理位置信息

#country

国家

文本

用户所在国家，根据 IP 地址生成

#country_code

国家代码

文本

用户所在国家的国家代码(ISO 3166-1 alpha-2，即两位大写英文字母)，根据 IP 地址生成

#province

省份

文本

用户所在省份，根据 IP 地址生成

#city

城市

文本

用户所在城市，根据 IP 地址生成

#os

操作系统

文本

如 MacOS,Windows等

#device_id

设备 ID

文本

用户的设备 ID

#screen_height

屏幕高度

数值

用户设备的屏幕高度，如 1920 等

#screen_width

屏幕宽度

数值

用户设备的屏幕高度，如 1080 等

#lib

SDK 类型

文本

您接入 SDK 的类型，如 Android，iOS 等

#lib_version

SDK 版本

文本

您接入 SDK 的版本

#zone_offset

时区偏移

数值

数据时间相对 UTC 时间的偏移小时数

#system_language

系统语言

文本

用户设备的系统语言(ISO 639-1，即两位小写英文字母)，如 zh, en 等

### 二、获取预置属性

服务端埋点需要 App 端的一些预置属性时，可以通过此方法获取 App 端的预置属性，再传给服务端。

```
   //获取属性对象
   TDPresetProperties* presetProperties =  TDAnalytics::getPresetProperties();

   //生成事件预置属性
   TDJSONObject* properties = presetProperties->toEventPresetProperties();
   /*
   {
        "#carrier": "中国电信",
        "#os": "Android",
        "#device_id": "abb8e87bfb5ce66c",
        "#screen_height": 2264,
        "#bundle_id": "com.sw.thinkingdatademo",
        "#manufacturer": "realme",
        "#device_model": "RMX1991",
        "#screen_width": 1080,
        "#system_language": "zh",
        "#os_version": "10",
        "#network_type": "WIFI",
        "#zone_offset": 8，
        "#app_version":"1.0"
    }
   */

    //获取某个预置属性
    string bundleId = presetProperties->bundleId;//包名
    string os =  presetProperties->os;//os类型，如Android
    string systemLanguage = presetProperties->systemLanguage;//手机系统语言类型
    int screenWidth = presetProperties->screenWidth;//屏幕宽度
    int screenHeight = presetProperties->screenHeight;//屏幕高度
    string deviceModel = presetProperties->deviceModel;//设备型号
    string deviceId = presetProperties->deviceId;//设备唯一标识
    string carrier = presetProperties->carrier;//手机SIM卡运营商信息，双卡双待时，取主卡的运营商信息
    string manufacture = presetProperties->manufacturer;//手机制造商 如HuaWei
    string networkType = presetProperties->networkType;//网络类型
    string osVersion = presetProperties->osVersion;//系统版本号
    string appVersion = presetProperties->appVersion;//app版本号
    double zoneOffset = presetProperties->zoneOffset;//时区偏移值
```

<!-- unsupported block: 34 -->

IP，国家城市信息由服务端解析生成，客户端不提供接口获取这些属性
