跳到正文
本頁目錄

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