📱 設備信息對象 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 | 運動控制器 |