---
code: cocos2d_lua_sdk_preset_properties
name: "预置属性"
wikiToken: M9iBwKbTyiOJwekIFHqc8hcDn6T
parentWikiToken: MERNwrahSimELOkM6wbcwBUsnze
updateTime: 1745310885000
sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=cocos2d_lua_sdk_preset_properties
---
# 预置属性

#### 一、 预置属性说明

<!-- unsupported block: 34 -->

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

#### 二、 获取预置属性

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

```
-- 获取属性对象
local presetProperties = TDAnalytics.getPresetProperties()

-- 生成事件预置属性
local 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"
    }
]]--

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

<!-- unsupported block: 34 -->

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

###
