設(shè)備管理

本模塊提供分布式設(shè)備管理能力。

系統(tǒng)應(yīng)用可調(diào)用接口實(shí)現(xiàn)如下功能：

注冊和解除注冊設(shè)備上下線變化監(jiān)聽
發(fā)現(xiàn)周邊不可信設(shè)備
認(rèn)證和取消認(rèn)證設(shè)備
查詢可信設(shè)備列表
查詢本地設(shè)備信息，包括設(shè)備名稱，設(shè)備類型和設(shè)備標(biāo)識

說明：
本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
本模塊接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用。
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import deviceManager from '@ohos.distributedHardware.deviceManager';

deviceManager.createDeviceManager

createDeviceManager(bundleName: string, callback: AsyncCallback): void

創(chuàng)建一個(gè)設(shè)備管理器實(shí)例。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

參數(shù)名	類型	必填	說明
bundleName	string	是	指示應(yīng)用程序的包名。
callback	AsyncCallback<[DeviceManager]>	是	DeviceManager實(shí)例創(chuàng)建時(shí)調(diào)用的回調(diào)，返回設(shè)備管理器對象實(shí)例。

示例：

deviceManager.createDeviceManager("ohos.samples.jshelloworld", (err, data) = > {     
    if (err) { 
        console.info("createDeviceManager err:" + JSON.stringify(err));    
        return;
    }
    console.info("createDeviceManager success");
    this.dmInstance = data;
});

DeviceInfo

設(shè)備信息。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	類型	必填	描述
deviceId	string	是	設(shè)備的唯一標(biāo)識。
deviceName	string	是	設(shè)備名稱。
deviceType	[DeviceType]	是	設(shè)備類型。
networkId8+	string	是	設(shè)備網(wǎng)絡(luò)標(biāo)識。

DeviceType

表示設(shè)備類型的枚舉類。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	默認(rèn)值	說明
SPEAKER	0x0A	智能音箱
PHONE	0x0E	手機(jī)
TABLET	0x11	平板
WEARABLE	0x6D	智能穿戴
TV	0x9C	智慧屏
CAR	0x83	車
UNKNOWN_TYPE	0	未知設(shè)備

DeviceStateChangeAction

表示設(shè)備狀態(tài)變化的枚舉。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	默認(rèn)值	說明
ONLINE	0	設(shè)備上線。
READY	1	設(shè)備就緒，設(shè)備信息同步已完成。
OFFLINE	2	設(shè)備下線。
CHANGE	3	設(shè)備信息更改。

SubscribeInfo

發(fā)現(xiàn)信息。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	類型	必填	描述
subscribeId	number	是	發(fā)現(xiàn)標(biāo)識，用于標(biāo)識不同的發(fā)現(xiàn)周期。
mode	[DiscoverMode]	否	發(fā)現(xiàn)模式。
medium	[ExchangeMedium]	否	發(fā)現(xiàn)類型。
freq	[ExchangeFreq]	否	發(fā)現(xiàn)頻率。
isSameAccount	boolean	否	是否同賬號。
isWakeRemote	boolean	否	是否喚醒設(shè)備。
capability	[SubscribeCap]	否	發(fā)現(xiàn)能力。

DiscoverMode

表示發(fā)現(xiàn)模式的枚舉。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	默認(rèn)值	說明
DISCOVER_MODE_PASSIVE	0x55	被動(dòng)模式。
DISCOVER_MODE_ACTIVE	0xAA	主動(dòng)模式。

ExchangeMedium

表示發(fā)現(xiàn)類型的枚舉。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	默認(rèn)值	說明
AUTO	0	自動(dòng)發(fā)現(xiàn)類型。
BLE	1	藍(lán)牙發(fā)現(xiàn)類型。
COAP	2	WiFi發(fā)現(xiàn)類型。
USB	3	USB發(fā)現(xiàn)類型。

ExchangeFreq

表示發(fā)現(xiàn)頻率的枚舉。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	默認(rèn)值	說明
LOW	0	低頻率。
MID	1	中頻率。
HIGH	2	高頻率。
SUPER_HIGH	3	超高頻率。

SubscribeCap

表示發(fā)現(xiàn)能力的枚舉。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	默認(rèn)值	說明
SUBSCRIBE_CAPABILITY_DDMP	0	DDMP能力，后續(xù)會(huì)被廢棄。
SUBSCRIBE_CAPABILITY_OSD	1	OSD能力。

AuthParam

認(rèn)證參數(shù)。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	類型	必填	描述
authType	number	是	認(rèn)證類型。
extraInfo	{[key:string] : any}	否	認(rèn)證參數(shù)可擴(kuò)展字段。

AuthInfo

認(rèn)證信息。

系統(tǒng)能力 ：以下各項(xiàng)對應(yīng)的系統(tǒng)能力均為SystemCapability.DistributedHardware.DeviceManager

名稱	類型	必填	描述
authType	number	是	認(rèn)證類型。
token	number	是	認(rèn)證Token。
extraInfo	{[key:string] : any}	否	認(rèn)證信息可擴(kuò)展字段。

DeviceManager

設(shè)備管理實(shí)例，用于獲取可信設(shè)備和本地設(shè)備的相關(guān)信息。在調(diào)用DeviceManager的方法前，需要先通過createDeviceManager構(gòu)建一個(gè)DeviceManager實(shí)例dmInstance。

release

release(): void

設(shè)備管理實(shí)例不再使用后，通過該方法釋放DeviceManager實(shí)例。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

示例：
```
dmInstance.release();
```

getTrustedDeviceListSync

getTrustedDeviceListSync(): Array

同步獲取所有可信設(shè)備列表。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

返回值：
名稱說明
Array<[DeviceInfo]> 返回可信設(shè)備列表。

名稱	說明
Array<[DeviceInfo]>	返回可信設(shè)備列表。

示例：

var deviceInfoList = dmInstance.getTrustedDeviceListSync();

getTrustedDeviceList8+

getTrustedDeviceList(callback:AsyncCallback>): void

獲取所有可信設(shè)備列表。使用callback異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：
名稱參數(shù)類型必填說明
callback AsyncCallback> 是獲取所有可信設(shè)備列表的回調(diào)，返回設(shè)備信息。

名稱	參數(shù)類型	必填	說明
callback	AsyncCallback>	是	獲取所有可信設(shè)備列表的回調(diào)，返回設(shè)備信息。

示例：

dmInstance.getTrustedDeviceList((err, data) = > {
    console.log("getTrustedDeviceList err: " + JSON.stringify(err));
    console.log('get trusted device info: ' + JSON.stringify(data));
  }
);

getTrustedDeviceList8+

getTrustedDeviceList(): Promise>

獲取所有可信設(shè)備列表。使用Promise異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

返回值：
類型說明
Promise> Promise實(shí)例，用于獲取異步返回結(jié)果。

類型	說明
Promise>	Promise實(shí)例，用于獲取異步返回結(jié)果。

示例：

dmInstance.getTrustedDeviceList().then((data) = > { 
    console.log('get trusted device info: ' + JSON.stringify(data));
}).catch((err) = > {
    console.log("getTrustedDeviceList err: " + JSON.stringify(err));
});

getLocalDeviceInfoSync8+

getLocalDeviceInfoSync(): [DeviceInfo]

同步獲取本地設(shè)備信息。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

返回值：
名稱說明
Array<[DeviceInfo]> 返回可信設(shè)備列表。

名稱	說明
Array<[DeviceInfo]>	返回可信設(shè)備列表。

示例：

var deviceInfo = dmInstance.getLocalDeviceInfoSync();

getLocalDeviceInfo8+

getLocalDeviceInfo(callback:AsyncCallback): void

獲取本地設(shè)備信息。使用callback異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：
名稱參數(shù)類型必填說明
callback AsyncCallback<[DeviceInfo]> 是獲取本地設(shè)備信息。

名稱	參數(shù)類型	必填	說明
callback	AsyncCallback<[DeviceInfo]>	是	獲取本地設(shè)備信息。

示例：

dmInstance.getLocalDeviceInfo((err, data) = > {
    console.log("getLocalDeviceInfo err: " + JSON.stringify(err));
    console.log('get local device info: ' + JSON.stringify(data));
  }
);

getLocalDeviceInfo8+

getLocalDeviceInfo(): Promise

獲取本地設(shè)備信息。使用Promise異步回調(diào)。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

返回值：
類型說明
Promise<[DeviceInfo]> Promise實(shí)例，用于獲取異步返回結(jié)果。

類型	說明
Promise<[DeviceInfo]>	Promise實(shí)例，用于獲取異步返回結(jié)果。

示例：

dmInstance.getLocalDeviceInfo().then((data) = > { 
    console.log('get local device info: ' + JSON.stringify(data));
}).catch((err) = > {
    console.log("getLocalDeviceInfo err: " + JSON.stringify(err));
});

startDeviceDiscovery

startDeviceDiscovery(subscribeInfo: SubscribeInfo): void

發(fā)現(xiàn)周邊設(shè)備。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：
名稱參數(shù)類型必填說明
subscribeInfo [SubscribeInfo] 是發(fā)現(xiàn)信息。

名稱	參數(shù)類型	必填	說明
subscribeInfo	[SubscribeInfo]	是	發(fā)現(xiàn)信息。

示例：

//生成發(fā)現(xiàn)標(biāo)識，隨機(jī)數(shù)確保每次調(diào)用發(fā)現(xiàn)接口的標(biāo)識不一致
var subscribeId = Math.floor(Math.random() * 10000 + 1000);
var subscribeInfo = {
    "subscribeId": subscribeId,
    "mode": 0xAA, //主動(dòng)模式
    "medium": 0,  //自動(dòng)發(fā)現(xiàn)類型，同時(shí)支持多種發(fā)現(xiàn)類型
    "freq": 2,    //高頻率
    "isSameAccount": false,
    "isWakeRemote": false,
    "capability": 1
};
dmInstance.startDeviceDiscovery(subscribeInfo); //當(dāng)有設(shè)備發(fā)現(xiàn)時(shí)，通過deviceFound回調(diào)通知給應(yīng)用程序

stopDeviceDiscovery

stopDeviceDiscovery(subscribeId: number): void

停止發(fā)現(xiàn)周邊設(shè)備。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：
名稱參數(shù)類型必填說明
subscribeId number 是發(fā)現(xiàn)標(biāo)識。

名稱	參數(shù)類型	必填	說明
subscribeId	number	是	發(fā)現(xiàn)標(biāo)識。

示例：

//入?yún)⑿枰蛃tartDeviceDiscovery接口傳入的subscribeId配對使用
dmInstance.stopDeviceDiscovery(subscribeId);

authenticateDevice

authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: AsyncCallback<{deviceId: string, pinToken ?: number}>): void

認(rèn)證設(shè)備。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
deviceInfo	[DeviceInfo]	是	設(shè)備信息。
authParam	[AuthParam]	是	認(rèn)證參數(shù)。
callback	AsyncCallback<{ deviceId: string, pinToken ?: number }>	是	認(rèn)證結(jié)果回調(diào)。

示例：

//認(rèn)證的設(shè)備信息，可以從發(fā)現(xiàn)的結(jié)果中獲取
var deviceInfo ={
    "deviceId": "XXXXXXXX",
    "deviceName": "",
    deviceType: 0x0E
};
let authParam = {
    "authType": 1, //認(rèn)證類型： 1 - 無賬號PIN碼認(rèn)證
    "extraInfo": {} 
}
dmInstance.authenticateDevice(deviceInfo, authParam, (err, data) = > {
    if (err) {
        console.info(TAG + "authenticateDevice err:" + JSON.stringify(err));
        return;
    }
    console.info(TAG + "authenticateDevice result:" + JSON.stringify(data));
    token = data.pinToken;
});

unAuthenticateDevice8+

unAuthenticateDevice(deviceInfo: DeviceInfo): void

解除認(rèn)證設(shè)備。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：
名稱參數(shù)類型必填說明
deviceInfo [DeviceInfo] 是設(shè)備信息。

示例：

dmInstance.unAuthenticateDevice(deviceInfo);

verifyAuthInfo

verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, level: number}>): void

驗(yàn)證認(rèn)證信息。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：
名稱參數(shù)類型必填說明
authInfo [AuthInfo] 是認(rèn)證信息。
authInfo AsyncCallback<{ deviceId: string, level: number }> 是驗(yàn)證結(jié)果回調(diào)。

名稱	參數(shù)類型	必填	說明
authInfo	[AuthInfo]	是	認(rèn)證信息。
authInfo	AsyncCallback<{ deviceId: string, level: number }>	是	驗(yàn)證結(jié)果回調(diào)。

示例：

let authInfo = {
  "authType": 1,
  "token": xxxxxx,
  "extraInfo": {}
}
dmInstance.verifyAuthInfo(authInfo, (err, data) = > {
  if (err) {
      console.info(TAG + "verifyAuthInfo err:" + JSON.stringify(err));
      return;
  }
  console.info(TAG + "verifyAuthInfo result:" + JSON.stringify(data));
});

on('deviceStateChange')

on(type: 'deviceStateChange', callback: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void

注冊設(shè)備狀態(tài)回調(diào)。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
type	string	是	注冊設(shè)備狀態(tài)回調(diào)，固定為deviceStateChange。
callback	Callback<{ action: [DeviceStateChangeAction], device: [DeviceInfo] }>	是	指示要注冊的設(shè)備狀態(tài)回調(diào)，返回設(shè)備狀態(tài)和設(shè)備信息。

示例：

dmInstance.on('deviceStateChange', (data) = > {      
      console.info("deviceStateChange on:" + JSON.stringify(data));
    }
);

off('deviceStateChange')

off(type: 'deviceStateChange', callback?: Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>): void

取消注冊設(shè)備狀態(tài)回調(diào)。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
type	string	是	根據(jù)應(yīng)用程序的包名取消注冊設(shè)備狀態(tài)回調(diào)。
callback	Callback<{ action: [DeviceStateChangeAction], device: [DeviceInfo] }>	是	指示要取消注冊的設(shè)備狀態(tài)回調(diào)，返回設(shè)備狀態(tài)和設(shè)備信息。

示例：

dmInstance.off('deviceStateChange', (data) = > {      
      console.info('deviceStateChange' + JSON.stringify(data));
   }
);

on('deviceFound')

on(type: 'deviceFound', callback: Callback<{ subscribeId: number, device: DeviceInfo }>): void

注冊發(fā)現(xiàn)設(shè)備回調(diào)監(jiān)聽。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
type	string	是	注冊設(shè)備發(fā)現(xiàn)回調(diào)，以便在發(fā)現(xiàn)周邊設(shè)備時(shí)通知應(yīng)用程序。
callback	Callback<{ subscribeId: number, device: DeviceInfo }>	是	注冊設(shè)備發(fā)現(xiàn)的回調(diào)方法。

示例：

dmInstance.on('deviceFound', (data) = > {
      console.info("deviceFound:" + JSON.stringify(data));
    }
);

off('deviceFound')

off(type: 'deviceFound', callback?: Callback<{ subscribeId: number, device: DeviceInfo }>): void

取消注冊設(shè)備發(fā)現(xiàn)回調(diào)。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
type	string	是	取消注冊設(shè)備發(fā)現(xiàn)回調(diào)。
callback	Callback<{ subscribeId: number, device: DeviceInfo }>	是	指示要取消注冊的設(shè)備發(fā)現(xiàn)回調(diào)，返回設(shè)備狀態(tài)和設(shè)備信息。

示例：

dmInstance.off('deviceFound', (data) = > {      
      console.info('deviceFound' + JSON.stringify(data));
    }
);

on('discoverFail')

on(type: 'discoverFail', callback: Callback<{ subscribeId: number, reason: number }>): void

注冊設(shè)備發(fā)現(xiàn)失敗回調(diào)監(jiān)聽。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
type	string	是	注冊設(shè)備發(fā)現(xiàn)失敗回調(diào)，以便在發(fā)現(xiàn)周邊設(shè)備失敗時(shí)通知應(yīng)用程序。
callback	Callback<{ subscribeId: number, reason: number }>	是	注冊設(shè)備發(fā)現(xiàn)失敗的回調(diào)方法。

示例：

dmInstance.on('discoverFail', (data) = > {
      this.log("discoverFail on:" + JSON.stringify(data));
    }
);

off('discoverFail')

off(type: 'discoverFail', callback?: Callback<{ subscribeId: number, reason: number }>): void

取消注冊設(shè)備發(fā)現(xiàn)失敗回調(diào)。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
type	string	是	取消注冊設(shè)備發(fā)現(xiàn)失敗回調(diào)。
callback	Callback<{ subscribeId: number, reason: number }>	是	指示要取消注冊的設(shè)備發(fā)現(xiàn)失敗回調(diào)。

示例：

dmInstance.off('deviceFound', (data) = > {      
      console.info('deviceFound' + JSON.stringify(data));
    }
);

on('serviceDie')

on(type: 'serviceDie', callback: () => void): void

注冊設(shè)備管理服務(wù)死亡監(jiān)聽。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
type	string	是	注冊serviceDie回調(diào)，以便在devicemanager服務(wù)異常終止時(shí)通知應(yīng)用程序。
callback	() => void	是	注冊serviceDie的回調(diào)方法。

示例：

dmInstance.on("serviceDie", () = > {      
      console.info("serviceDie on");
   }
);

off('serviceDie')

off(type: 'serviceDie', callback?: () => void): void

取消注冊設(shè)備管理服務(wù)死亡監(jiān)聽。

系統(tǒng)能力 ：SystemCapability.DistributedHardware.DeviceManager

參數(shù)：

名稱	參數(shù)類型	必填	說明
type	string	是	取消注冊serviceDie回調(diào)，以便在devicemanager服務(wù)異常終止時(shí)通知應(yīng)用程序。
callback	() => void	否	取消注冊serviceDie的回調(diào)方法。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

搜狗高速瀏覽器截圖20240326151450.png

示例：

dmInstance.off("serviceDie", () = > {      
      console.info("serviceDie off");
  }
);

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。舉報(bào)投訴

鴻蒙

鴻蒙

+關(guān)注

關(guān)注
60

文章
2979

瀏覽量
46007

91欧美超碰AV自拍|国产成年人性爱视频免费看|亚洲日韩欧美一厂二区入|人人看人人爽人人操aV|丝袜美腿视频一区二区在线看|人人操人人爽人人爱|婷婷五月天超碰|97色色欧美亚州A√|另类A√无码精品一级av|欧美特级日韩特级

搜索歷史

鴻蒙開發(fā)設(shè)備管理：ohos.distributedHardware.deviceManager 設(shè)備管理

設(shè)備管理

導(dǎo)入模塊

deviceManager.createDeviceManager

DeviceInfo

DeviceType

DeviceStateChangeAction

SubscribeInfo

DiscoverMode

ExchangeMedium

ExchangeFreq

SubscribeCap

AuthParam

AuthInfo

DeviceManager

release

getTrustedDeviceListSync

getTrustedDeviceList8+

getTrustedDeviceList8+

getLocalDeviceInfoSync8+

getLocalDeviceInfo8+

getLocalDeviceInfo8+

startDeviceDiscovery

stopDeviceDiscovery

authenticateDevice

unAuthenticateDevice8+

verifyAuthInfo

on('deviceStateChange')

off('deviceStateChange')

on('deviceFound')

off('deviceFound')

on('discoverFail')

off('discoverFail')

on('serviceDie')

off('serviceDie')

評論