📱 设备信息对象 API
在脚本引擎中，使用「设备信息对象」来操作和获取某一个玩家使用的游戏设备的相关信息。
获取一个设备信息对象
通过玩家获取
通过玩家对象的.getDevice成员函数，来获取一个玩家对应的设备信息对象
详见 玩家对象 API
注意：不要长期保存一个设备信息对象
当设备对应的玩家退出游戏时，对应的对象将同时释放。因此，如果有长期操作某个对象的需要，请通过上述途径获取实时的设备信息对象
设备信息对象 - 属性
每一个设备信息对象都包含一些固定的对象属性。对于某个特定的实体对象dv，有以下这些属性
| 属性 | 含义 | 类型 |
|---|---|---|
| dv.ip | 玩家设备的IP地址 | String |
| dv.avgPing | 玩家的平均网络延迟时间（ms） | Integer |
| dv.avgPacketLoss | 玩家的平均网络丢包率（%） | Float |
| dv.lastPing | 玩家的网络延迟时间（ms） | Integer |
| dv.lastPacketLoss | 玩家的网络丢包率（%） | Float |
| dv.os | 玩家设备的操作系统类型 | String |
| dv.inputMode | 玩家的操作模式 | Integer |
| dv.serverAddress | 玩家连接的地址 | String |
| dv.clientId | 玩家客户端的识别码ID | String |
这些对象属性都是只读的，无法被修改
其中，操作系统类型属性返回一个字符串，记录了玩家设备的操作系统。可能返回的值如下表
| dv.os返回字符串 | 玩家设备的操作系统 |
|---|---|
Google | 手机谷歌Android |
IOS | 手机苹果iOS/平板iPadOS |
Osx | 电脑苹果macOS |
Amazon | 平板/电视亚马逊FireOS |
GearVRDeprecated | 头显三星GearVR（已弃用） |
UwpDeprecated | 电脑微软Windows UWP（已弃用） |
Win32 | 电脑微软Windows |
Dedicated | 专用服务器 |
TvOSDeprecated | 机顶盒苹果tvOS（已弃用） |
Sony | 主机索尼PlayStation |
Nintendo | 掌机任天堂Switch |
Xbox | 主机微软Xbox |
WindowsPhoneDeprecated | 手机微软Windows Mobile（已弃用） |
Linux | Linux |
Unknown | 未知系统 |
| Input mode ENUM | 备注 |
|---|---|
InputMode.Mouse | 鼠标 |
InputMode.Touch | 触屏 |
InputMode.GamePad | 手柄 |
InputMode.MotionController | 运动控制器 |