harmony 鸿蒙@ohos.distributedHardware.deviceManager (Device Management) (System API)

2025-06-12
浏览 (4)

@ohos.distributedHardware.deviceManager (Device Management) (System API)

The APIs of this module are deprecated. You are advised to use @ohos.distributedDeviceManager.

The deviceManager module provides APIs for distributed device management.

System applications can call the APIs to do the following:

Subscribe to or unsubscribe from device state changes.
Discover devices nearby.
Authenticate or deauthenticate a device.
Query the trusted device list.
Query local device information, including the device name, type, and ID.
Publishes device information for discovery purposes.

NOTE

The initial APIs of this module are supported since API version 7. Newly added APIs will be marked with a superscript to indicate their earliest API version.

The APIs of this module are system APIs and cannot be called by third-party applications.

Modules to Import

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

deviceManager.createDeviceManager

createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager>): void

Creates a DeviceManager instance.

NOTE
This API is deprecated since API version 11. Use deviceManager.createDeviceManager instead.

System capability: SystemCapability.DistributedHardware.DeviceManager

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.

Parameters

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name of the application. The value is a string of 1 to 255 characters.
callback	AsyncCallback<DeviceManager>	Yes	Callback used to return the DeviceManager instance created.

Example

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  let dmInstance: deviceManager.DeviceManager|null = null;
  try {
    deviceManager.createDeviceManager("ohos.samples.jshelloworld", (err: BusinessError, data: deviceManager.DeviceManager) => {
      if (err) { 
        console.error("createDeviceManager errCode:" + err.code + ",errMessage:" + err.message);
        return;
      }
      console.info("createDeviceManager success");
      dmInstance = data;
    });
  } catch(err) {
    let e: BusinessError = err as BusinessError;
    console.error("createDeviceManager errCode:" + e.code + ",errMessage:" + e.message);
  }

DeviceInfo

Defines device information.

NOTE
This API is deprecated since API version 11. Use DeviceBasicInfo instead.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Type	Mandatory	Description
deviceId	string	Yes	Unique identifier of the device.
deviceName	string	Yes	Device name.
deviceType	DeviceType	Yes	Device type.
networkId⁸⁺	string	Yes	Network ID of the device.
range⁹⁺	number	Yes	Distance between the discovered device and the device that initiates device discovery.
authForm¹⁰⁺	AuthForm	Yes	Authentication type of the device.

DeviceType

Enumerates the device types.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Value	Description
SPEAKER	0x0A	Smart speaker.
PHONE	0x0E	Phone.
TABLET	0x11	Tablet
WEARABLE	0x6D	Wearable
TV	0x9C	Smart TV
CAR	0x83	Car.
UNKNOWN_TYPE	0	Unknown device type.

AuthForm¹⁰⁺

Enumerates the device authentication types.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Value	Description
INVALID_TYPE	-1	No authentication.
PEER_TO_PEER	0	Point-to-point authentication for devices without accounts.
IDENTICAL_ACCOUNT	1	Authentication for devices using the same account.
ACROSS_ACCOUNT	2	Authentication for devices using different accounts.

DeviceStateChangeAction

Enumerates the device states.

NOTE
This API is deprecated since API version 11. Use DeviceStateChange instead.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Value	Description
ONLINE	0	The device is physically online.
READY	1	The information between devices has been synchronized in the Distributed Data Service (DDS) module, and the device is ready for running distributed services.
OFFLINE	2	The device is physically offline.
CHANGE	3	The device information is changed.

SubscribeInfo

Defines subscription information.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Type	Mandatory	Description
subscribeId	number	Yes	Subscription ID, used to identify a device discovery period. The value ranges from 1 to 65535.
mode	DiscoverMode	Yes	Device discovery mode.
medium	ExchangeMedium	Yes	Medium used for device discovery.
freq	ExchangeFreq	Yes	Frequency of device discovery.
isSameAccount	boolean	No	Whether the account is the same as the current account. The value true indicates the same account and the value false indicates a different account.
isWakeRemote	boolean	No	Whether to wake up the device. The value true means to wake up the device and the value false means the opposite.
capability	SubscribeCap	Yes	Discovery capability.

DiscoverMode

Enumerates the device discovery modes.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Value	Description
DISCOVER_MODE_PASSIVE	0x55	Passive discovery.
DISCOVER_MODE_ACTIVE	0xAA	Active discovery.

ExchangeMedium

Enumerates the media used for device discovery.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Value	Description
AUTO	0	Automatic.
BLE	1	Bluetooth.
COAP	2	Wi-Fi.
USB	3	USB.

ExchangeFreq

Enumerates the device discovery frequencies.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Value	Description
LOW	0	Low frequency.
MID	1	Medium frequency.
HIGH	2	High frequency.
SUPER_HIGH	3	Ultra-high frequency.

SubscribeCap

Enumerates the discovery capabilities.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Value	Description
SUBSCRIBE_CAPABILITY_DDMP	0	DDMP capability. This will be deprecated later.
SUBSCRIBE_CAPABILITY_OSD	1	OSD capability.

AuthParam

Defines the authentication parameters.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Type	Mandatory	Description
authType	number	Yes	Authentication type.
extraInfo	{[key:string] : any}	No	Extended field. Optional. The default value is undefined.

AuthInfo

Defines authentication information.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Type	Mandatory	Description
authType	number	Yes	Authentication type.
token	number	Yes	Authentication token.
extraInfo	{[key:string] : any}	No	Extended field. Optional. The default value is undefined.

PublishInfo⁹⁺

Defines published device information.

NOTE
This API is deprecated since API version 11. There is no substitute API.

System capability: SystemCapability.DistributedHardware.DeviceManager

Name	Type	Mandatory	Description
publishId	number	Yes	ID used to identify a publication period.
mode	DiscoverMode	Yes	Device discovery mode.
freq	ExchangeFreq	Yes	Frequency of device discovery.
ranging	boolean	Yes	Whether the device supports ranging. The value true indicates that the device supports ranging and the value false indicates the opposite.

DeviceManager

Provides APIs to obtain information about trusted devices and local devices. Before calling any API in DeviceManager, you must use createDeviceManager to create a DeviceManager instance, for example, dmInstance.

release

release(): void

Releases this DeviceManager instance when it is no longer used.

NOTE
This API is deprecated since API version 11. Use deviceManager.releaseDeviceManager instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
11600101	Failed to execute the function.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  try {
    dmInstance.release();
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("release errCode:" + e.code + ",errMessage:" + e.message);
  }

getTrustedDeviceListSync

getTrustedDeviceListSync(): Array<DeviceInfo>

Obtains all trusted devices synchronously.

NOTE
This API is deprecated since API version 11. Use getAvailableDeviceListSync instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Return value

Name	Description
Array<DeviceInfo>	List of trusted devices obtained.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
11600101	Failed to execute the function.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  try {
    let deviceInfoList: Array<deviceManager.DeviceInfo> = dmInstance.getTrustedDeviceListSync();
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("getTrustedDeviceListSync errCode:" + e.code + ",errMessage:" + e.message);
  }

getTrustedDeviceListSync¹⁰⁺

getTrustedDeviceListSync(isRefresh: boolean): Array<DeviceInfo>

Enables the DSoftBus heartbeat mode to quickly bring offline trusted devices online and updates the list of online trusted devices.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
isRefresh	boolean	Yes	Whether to enable the heartbeat mode and update the list of online trusted devices. The value true means to enable the heartbeat mode and update the list of online trusted devices and the value false means the opposite.

Return value

Name	Description
Array<DeviceInfo>	List of trusted devices obtained.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed.
11600101	Failed to execute the function.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  try {
    let deviceInfoList: Array<deviceManager.DeviceInfo> = dmInstance.getTrustedDeviceListSync(true);
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("getTrustedDeviceListSync errCode:" + e.code + ",errMessage:" + e.message);
  }

getTrustedDeviceList⁸⁺

getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): void

Obtains all trusted devices. This API uses an asynchronous callback to return the result.

NOTE
This API is deprecated since API version 11. Use getAvailableDeviceList instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<Array<DeviceInfo>>	Yes	Callback used to return the list of trusted devices.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  try {
    dmInstance.getTrustedDeviceList((err: BusinessError, data: Array<deviceManager.DeviceInfo>) => {
      if (err) {
        console.error("getTrustedDeviceList errCode:" + err.code + ",errMessage:" + err.message);
        return;
      }
      console.log('get trusted device info: ' + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("getTrustedDeviceList errCode:" + e.code + ",errMessage:" + e.message);
  }

getTrustedDeviceList⁸⁺

getTrustedDeviceList(): Promise<Array<DeviceInfo>>

Obtains all trusted devices. This API uses a promise to return the result.

NOTE
This API is deprecated since API version 11. Use getAvailableDeviceList instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Return value

Type	Description
Promise<Array<DeviceInfo>>	Promise used to return the result.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  dmInstance.getTrustedDeviceList().then((data: Array<deviceManager.DeviceInfo>) => {
    console.log('get trusted device info: ' + JSON.stringify(data));
    }).catch((err: BusinessError) => {
      console.error("getTrustedDeviceList errCode:" + err.code + ",errMessage:" + err.message);
  });

getLocalDeviceInfoSync⁸⁺

getLocalDeviceInfoSync(): DeviceInfo

Obtains local device information synchronously.

NOTE
This API is deprecated since API version 11. Use getLocalDeviceNetworkId, getLocalDeviceName, getLocalDeviceType, or getLocalDeviceId instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Return value

Name	Description
DeviceInfo	List of local devices obtained.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
11600101	Failed to execute the function.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  try {
    let deviceInfo: deviceManager.DeviceInfo = dmInstance.getLocalDeviceInfoSync();
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("getLocalDeviceInfoSync errCode:" + e.code + ",errMessage:" + e.message);
  }

getLocalDeviceInfo⁸⁺

getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void

Obtains local device information. This API uses an asynchronous callback to return the result.

NOTE
This API is deprecated since API version 11. Use getLocalDeviceNetworkId, getLocalDeviceName, getLocalDeviceType, or getLocalDeviceId instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<DeviceInfo>	Yes	Callback used to return the local device information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';


  try {
    dmInstance.getLocalDeviceInfo((err: BusinessError, data: deviceManager.DeviceInfo) => {
      if (err) {
        console.error("getLocalDeviceInfo errCode:" + err.code + ",errMessage:" + err.message);
        return;
      }
      console.log('get local device info: ' + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("getLocalDeviceInfo errCode:" + e.code + ",errMessage:" + e.message);
  }

getLocalDeviceInfo⁸⁺

getLocalDeviceInfo(): Promise<DeviceInfo>

Obtains local device information. This API uses a promise to return the result.

NOTE
This API is deprecated since API version 11. Use getLocalDeviceNetworkId, getLocalDeviceName, getLocalDeviceType, or getLocalDeviceId instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Return value

Type	Description
Promise<DeviceInfo>	Promise used to return the result.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  dmInstance.getLocalDeviceInfo().then((data: deviceManager.DeviceInfo) => {
    console.log('get local device info: ' + JSON.stringify(data));
  }).catch((err: BusinessError) => {
    console.error("getLocalDeviceInfo errCode:" + err.code + ",errMessage:" + err.message);
  });

getDeviceInfo¹⁰⁺

getDeviceInfo(networkId: string, callback:AsyncCallback<DeviceInfo>): void

Obtains the information about a specific device based on the network ID. This API uses an asynchronous callback to return the result.

NOTE
This API is deprecated since API version 11. Use getDeviceName and getDeviceType instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
networkId	string	Yes	Network ID of the device. The value is a string of 1 to 255 characters.
callback	AsyncCallback<DeviceInfo>	Yes	Callback used to return the information about the specified device.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified networkId is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  try {
    // Network ID of the device, which can be obtained from the trusted device list
    let networkId = "xxxxxxx";
    dmInstance.getDeviceInfo(networkId, (err: BusinessError, data: deviceManager.DeviceInfo) => {
      if (err) {
        console.error("getDeviceInfo errCode:" + err.code + ",errMessage:" + err.message);
        return;
      }
      console.log('get device info: ' + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("getDeviceInfo errCode:" + e.code + ",errMessage:" + e.message);
  }

getDeviceInfo¹⁰⁺

getDeviceInfo(networkId: string): Promise<DeviceInfo>

Obtains the information about a specific device based on the network ID. This API uses a promise to return the result.

NOTE
This API is deprecated since API version 11. Use getDeviceName and getDeviceType instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
networkId	string	Yes	Network ID of the device. The value is a string of 1 to 255 characters.

Return value

Type	Description
Promise<DeviceInfo>	Promise used to return the result.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified networkId is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  // Network ID of the device, which can be obtained from the trusted device list
  let networkId = "xxxxxxx";
  dmInstance.getDeviceInfo(networkId).then((data: deviceManager.DeviceInfo) => {
    console.log('get device info: ' + JSON.stringify(data));
  }).catch((err: BusinessError) => {
    console.error("getDeviceInfo errCode:" + err.code + ",errMessage:" + err.message);
  });

startDeviceDiscovery⁸⁺

startDeviceDiscovery(subscribeInfo: SubscribeInfo): void

Starts to discover peripheral devices. The discovery process lasts 2 minutes. A maximum of 99 devices can be discovered.

NOTE
This API is deprecated since API version 11. Use startDiscovering instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
subscribeInfo	SubscribeInfo	Yes	Subscription information.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified networkId is greater than 255.
11600101	Failed to execute the function.
11600104	Discovery unavailable.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  interface SubscribeInfo {
    subscribeId: number;
    mode: number, // Active discovery
    medium: number,  // Automatic. Multiple media can be used for device discovery.
    freq: number,    // High frequency
    isSameAccount: boolean;
    isWakeRemote: boolean;
    capability: number;
  }

  // Automatically generate a unique subscription ID.
  let subscribeId = Math.floor(Math.random() * 10000 + 1000);
  let subscribeInfo: SubscribeInfo = {
    subscribeId: subscribeId,
    mode: 0xAA, // Active discovery
    medium: 0,  // Automatic. Multiple media can be used for device discovery.
    freq: 2,    // High frequency
    isSameAccount: false,
    isWakeRemote: false,
    capability: 1
  };
  try {
    dmInstance.startDeviceDiscovery(subscribeInfo); // The deviceFound callback is called to notify the application when a device is discovered.
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("startDeviceDiscovery errCode:" + e.code + ",errMessage:" + e.message);
  }

startDeviceDiscovery⁹⁺

startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void

Starts to discover peripheral devices. The discovery process lasts 2 minutes. A maximum of 99 devices can be discovered.

NOTE
This API is deprecated since API version 11. Use startDiscovering instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
subscribeInfo	SubscribeInfo	Yes	Subscription information.
filterOptions	string	No	Options for filtering discovered devices. Optional. The default value is undefined, indicating that discovery of offline devices. The value is a string of 1 to 255 characters.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified networkId is greater than 255.
11600101	Failed to execute the function.
11600104	Discovery unavailable.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  interface Filters {
    type: string;
    value: number;
  }

  interface FilterOptions {
    filter_op: string, // Optional. The default value is OR.
    filters: Filters[];
  }

  interface SubscribeInfo {
    subscribeId: number;
    mode: number, // Active discovery
    medium: number,  // Automatic. Multiple media can be used for device discovery.
    freq: number,    // High frequency
    isSameAccount: boolean;
    isWakeRemote: boolean;
    capability: number;
  }

  // Automatically generate a unique subscription ID.
  let subscribeId = Math.floor(Math.random() * 10000 + 1000);
  let subscribeInfo: SubscribeInfo = {
    subscribeId: subscribeId,
    mode: 0xAA, // Active discovery
    medium: 0,  // Automatic. Multiple media can be used for device discovery.
    freq: 2,    // High frequency
    isSameAccount: false,
    isWakeRemote: false,
    capability: 1
  };

  let filters: Filters[] = [
    {
        type: "range",
        value: 50 // Filter discovered devices based on the distance (in cm).
    }
  ];

  let filterOptions: FilterOptions = {
    filter_op: "OR", // Optional. The default value is OR.
    filters: filters
  };
  try {
    dmInstance.startDeviceDiscovery(subscribeInfo, JSON.stringify(filterOptions)); // The deviceFound callback is invoked to notify the application when a device is discovered.
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("startDeviceDiscovery errCode:" + e.code + ",errMessage:" + e.message);
  }

stopDeviceDiscovery

stopDeviceDiscovery(subscribeId: number): void

Stops device discovery.

NOTE
This API is deprecated since API version 11. Use stopDiscovering instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
subscribeId	number	Yes	Subscription ID. The value ranges from 1 to 65535.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified networkId is greater than 255.
11600101	Failed to execute the function.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  try {
    // stopDeviceDiscovery and startDeviceDiscovery must be used in pairs, and the input parameter **subscribeId** passed in them must be the same.
    let subscribeId = 12345;
    dmInstance.stopDeviceDiscovery(subscribeId);
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("stopDeviceDiscovery errCode:" + e.code + ",errMessage:" + e.message);
  }

publishDeviceDiscovery⁹⁺

publishDeviceDiscovery(publishInfo: PublishInfo): void

Publishes device information for discovery purposes. The publish process lasts 2 minutes.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
publishInfo	PublishInfo	Yes	Device information to publish.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed.
11600101	Failed to execute the function.
11600105	Publish unavailable.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  interface PublishInfo {
    publishId: number;
    mode: number, // Active discovery
    freq: number,    // High frequency
    ranging: boolean // Whether the device supports reporting the distance to the discovery initiator.
  };

  // Automatically generate a unique subscription ID.
  let publishId = Math.floor(Math.random() * 10000 + 1000);
  let publishInfo: PublishInfo = {
    publishId: publishId,
    mode: 0xAA, // Active discovery
    freq: 2,    // High frequency
    ranging: true  // The device supports reporting the distance to the discovery initiator.
  };

  try {
    dmInstance.publishDeviceDiscovery(publishInfo); // A callback is invoked to notify the application when the device information is published.
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("publishDeviceDiscovery errCode:" + e.code + ",errMessage:" + e.message);
  }

unPublishDeviceDiscovery⁹⁺

unPublishDeviceDiscovery(publishId: number): void

Stops publishing device information.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
publishId	number	Yes	Publish ID. The value ranges from 1 to 2147483647.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed.
11600101	Failed to execute the function.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  try {
    // unPublishDeviceDiscovery and publishDeviceDiscovery must be used in pairs, and the input parameter **publishId** passed in them must be the same.
    let publishId = 12345;
    dmInstance.unPublishDeviceDiscovery(publishId);
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("unPublishDeviceDiscovery errCode:" + e.code + ",errMessage:" + e.message);
  }

authenticateDevice

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

Authenticates a device.

NOTE
This API is deprecated since API version 11. Use bindTarget instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
deviceInfo	DeviceInfo	Yes	Device information.
authParam	AuthParam	Yes	Authentication parameter.
callback	AsyncCallback<{deviceId: string, pinToken ?: number}>	Yes	Callback used to return the authentication result.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    deviceId: string = "";
    pinToken?: number = 0;
  }

  interface DeviceInfo {
    deviceId: string;
    deviceName: string;
    deviceType: number;
    networkId: string;
    range: number;
  };

  interface ExtraInfo {
    targetPkgName: string;
    appName: string;
    appDescription: string;
    business: string;
  }

  interface AuthParam {
    authType: number; // Authentication type. The value 1 means no account PIN authentication.
    extraInfo: ExtraInfo;
  }

  // Information about the device to authenticate. The information can be obtained from the device discovery result.
  let deviceInfo: deviceManager.DeviceInfo = {
    deviceId: "XXXXXXXX",
    deviceName: "",
    deviceType: 0x0E,
    networkId: "xxxxxxx",
    range: 0,
    authForm: 0
  };
  let extraInfo: ExtraInfo = {
    targetPkgName: 'ohos.samples.xxx',
    appName: 'xxx',
    appDescription: 'xxx',
    business: '0'
  };
  let authParam: AuthParam = {
    authType: 1, // Authentication type. The value 1 means no account PIN authentication.
    extraInfo: extraInfo
  };

  try {
    dmInstance.authenticateDevice(deviceInfo, authParam, (err: BusinessError, data: Data) => {
      if (err) {
        console.error("authenticateDevice errCode:" + err.code + ",errMessage:" + err.message);
        return;
      }
      console.info("authenticateDevice result:" + JSON.stringify(data));
      let token = data.pinToken;
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("authenticateDevice errCode:" + e.code + ",errMessage:" + e.message);
  }

unAuthenticateDevice⁸⁺

unAuthenticateDevice(deviceInfo: DeviceInfo): void

Deauthenticates a device.

NOTE
This API is deprecated since API version 11. Use unbindTarget instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
deviceInfo	DeviceInfo	Yes	Device information.

Error codes

For details about the error codes, see Universal Error Codes and Device Management Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed.
11600101	Failed to execute the function.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  interface DeviceInfo {
    deviceId: string;
    deviceName: string;
    deviceType: number;
    networkId: string;
    range: number;
  }

  try {
    let deviceInfo: deviceManager.DeviceInfo = {
      deviceId: "XXXXXXXX",
      deviceName: "",
      deviceType: 0x0E,
      networkId: "xxxxxxx",
      range: 0,
      authForm: 0
    };
    dmInstance.unAuthenticateDevice(deviceInfo);
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("unAuthenticateDevice errCode:" + e.code + ",errMessage:" + e.message);
  }

verifyAuthInfo

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

Verifies authentication information.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
authInfo	AuthInfo	Yes	Authentication information.
callback	AsyncCallback<{deviceId: string, level: number}>	Yes	Callback used to return the verification result.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  interface ExtraInfo {
    authType: number;
    token: number;
  }

  interface AuthInfo {
    authType: number;
    token: number;
    extraInfo: ExtraInfo;
  }

  class Data {
    deviceId: string = "";
    level: number = 0;
  }

  let extraInfo: ExtraInfo = {
    authType: 0,
    token: 0
  };

  let authInfo: AuthInfo = {
    authType: 1,
    token: 123456,
    extraInfo: extraInfo
  };
  try {
    dmInstance.verifyAuthInfo(authInfo, (err: BusinessError, data: Data) => {
      if (err) {
        console.error("verifyAuthInfo errCode:" + err.code + ",errMessage:" + err.message);
        return;
      }
    console.info("verifyAuthInfo result:" + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("verifyAuthInfo errCode:" + e.code + ",errMessage:" + e.message);
  }

setUserOperation⁹⁺

setUserOperation(operateAction: number, params: string): void

Sets a user operation.

NOTE
This API is deprecated since API version 11. Use replyUiAction instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
operateAction	number	Yes	User operation. The value ranges from 0 to 5.
params	string	Yes	Input parameters of the user. The value is a string of 1 to 255 characters.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
201	Permission verification failed. The application does not have the permission required to call the API.
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified params is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

 try {
    /*
      operateAction = 0 - Grant the permission.
      operateAction = 1 - Revoke the permission.
      operateAction = 2 - The user operation in the permission request dialog box times out.
      operateAction = 3 - Cancel the display of the PIN box.
      operateAction = 4 - Cancel the display of the PIN input box.
      operateAction = 5 - Confirm the input in the PIN input box.
    */
    let operation = 0;
    dmInstance.setUserOperation(operation, "extra");
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("setUserOperation errCode:" + e.code + ",errMessage:" + e.message);
  }

requestCredentialRegisterInfo¹⁰⁺

requestCredentialRegisterInfo(requestInfo: string, callback: AsyncCallback<{registerInfo: string}>): void

Obtains the registration information of the credential.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
requestInfo	string	Yes	Request credential information. The value contains a maximum of 255 characters.
callback	AsyncCallback<{registerInfo: string}>	Yes	Callback used to return the credential registration information.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified params is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  interface CredentialInfo {
    version: string;
    userId: string;
  }

  class Data {
    registerInfo: string = "";
  }

  let credentialInfo: CredentialInfo = {
    version: "1.2.3",
    userId: "123"
  };
  try {
    let jsonCredentialInfo = JSON.stringify(credentialInfo);
    dmInstance.requestCredentialRegisterInfo(jsonCredentialInfo, (err: BusinessError, data: Data) => {
      if (data) {
        console.info("requestCredentialRegisterInfo result:" + JSON.stringify(data));
      } else {
        console.info("requestCredentialRegisterInfo result: data is null");
      }
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("requestCredentialRegisterInfo err:" + e.code + "," + e.message);
  }

importCredential¹⁰⁺

importCredential(credentialInfo: string, callback: AsyncCallback<{resultInfo: string}>): void

Imports credential information.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
credentialInfo	string	Yes	Credential information to import. The value is a string of 1 to 64000 characters.
callback	AsyncCallback<{resultInfo: string}>	Yes	Callback used to return the result.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified credentialInfo is greater than 5999.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    resultInfo: string = "";
  }

  interface CredentialData {
    credentialType: number;
    credentialId: string;
    serverPk: string;
    pkInfoSignature : string;
    pkInfo: string;
    authCode: string;
    peerDeviceId: string;
  }

  interface CredentialInfo {
    processType: number;
    authType: number;
    userId: string;
    deviceId: string;
    version: string;
    devicePk : string;
    credentialData : CredentialData;
  }

  let credentialData: CredentialData = {
    credentialType: 2,
    credentialId: "102",
    serverPk: "3059301306072A8648CE3D020106082A8648CE3D03",
    pkInfoSignature : "30440220490BCB4F822004C9A76AB8D97F80041FC0E",
    pkInfo: "",
    authCode: "",
    peerDeviceId: ""
  };


  let credentialInfo: CredentialInfo = {
    processType: 1,
    authType: 1,
    userId: "123",
    deviceId: "aaa",
    version: "1.2.3",
    devicePk : "0000",
    credentialData : credentialData
  };

  try {
    let jsonCredentialInfo = JSON.stringify(credentialInfo);
    dmInstance.importCredential(jsonCredentialInfo, (err: BusinessError, data: Data) => {
      if (data) {
        console.info("importCredential result:" + JSON.stringify(data));
      } else {
        console.info("importCredential result: data is null");
      }
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("importCredential err:" + e.code + "," + e.message);
  }

deleteCredential¹⁰⁺

deleteCredential(queryInfo: string, callback: AsyncCallback<{resultInfo: string}>): void

Deletes credential information.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
queryInfo	string	Yes	Credential information to delete. The value is a string of 1 to 64000 characters.
callback	AsyncCallback<{resultInfo: string}>	Yes	Callback used to return the result.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified credentialInfo is greater than 5999.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    resultInfo: string = "";
  }

  interface QueryInfo {
    processType: number;
    authType: number;
    userId: string;
  }

  let queryInfo: QueryInfo = {
    processType: 1,
    authType: 1,
    userId: "123"
  };

  try {
    let jsonQueryInfo = JSON.stringify(queryInfo);
    dmInstance.deleteCredential(jsonQueryInfo, (err: BusinessError, data: Data) => {
      if (data) {
        console.info("deleteCredential result:" + JSON.stringify(data));
      } else {
        console.info("deleteCredential result: data is null");
      }
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("deleteCredential err:" + e.code + "," + e.message);
  }

on(‘uiStateChange’)⁹⁺

on(type: ‘uiStateChange’, callback: Callback<{ param: string}>): void

Subscribes to UI status changes.

NOTE
This API is deprecated since API version 11. Use on(‘replyResult’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of uiStateChange.
callback	Callback<{ param: string}>	Yes	Callback used to return the UI status.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    param: string = "";
  }

  interface TmpStr {
    verifyFailed: boolean;
  }

  try {
    dmInstance.on('uiStateChange', (data: Data) => {
      console.log("uiStateChange executed, dialog closed" + JSON.stringify(data));
      let tmpStr: TmpStr = JSON.parse(data.param);
      let isShow = tmpStr.verifyFailed;
      console.log("uiStateChange executed, dialog closed" + isShow);
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("uiStateChange errCode:" + e.code + ",errMessage:" + e.message);
  }

off(‘uiStateChange’)⁹⁺

off(type: ‘uiStateChange’, callback?: Callback<{ param: string}>): void

Unsubscribes from UI status changes.

NOTE
This API is deprecated since API version 11. Use off(‘replyResult’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of uiStateChange.
callback	Callback<{ param: string}>	No	Callback used to return the UI status.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  try {
    dmInstance.off('uiStateChange');
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("uiStateChange errCode:" + e.code + ",errMessage:" + e.message);
  }

on(‘deviceStateChange’)

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

Subscribes to changes in the device state.

NOTE
This API is deprecated since API version 11. Use on(‘deviceStateChange’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type. The value is deviceStateChange, which indicates a device state change event.
callback	Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>	Yes	Callback used to return the device information and state.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  class Data {
    action: deviceManager.DeviceStateChangeAction = 0;
    device: deviceManager.DeviceInfo = {
      deviceId: "",
      deviceName: "",
      deviceType: 0,
      networkId: "",
      range: 0,
      authForm:0
    };
  }

  try {
    dmInstance.on('deviceStateChange', (data: Data) => {
      console.info("deviceStateChange on:" + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("deviceStateChange errCode:" + e.code + ",errMessage:" + e.message);
  }

off(‘deviceStateChange’)

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

Unsubscribes from changes in the device state.

NOTE
This API is deprecated since API version 11. Use off(‘deviceStateChange’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of deviceStateChange.
callback	Callback<{ action: DeviceStateChangeAction, device: DeviceInfo }>	No	Callback used to return the device information and state.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  class Data {
    action: deviceManager.DeviceStateChangeAction = 0;
    device: deviceManager.DeviceInfo = {
      deviceId: "",
      deviceName: "",
      deviceType: 0,
      networkId: "",
      range: 0,
      authForm:0
    };
  }

  try {
    dmInstance.off('deviceStateChange', (data: Data) => {
      console.info('deviceStateChange' + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("deviceStateChange errCode:" + e.code + ",errMessage:" + e.message);
  }

on(‘deviceFound’)

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

Subscribes to device discovery events.

NOTE
This API is deprecated since API version 11. Use on(‘discoverSuccess’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of deviceFound.
callback	Callback<{ subscribeId: number, device: DeviceInfo }>	Yes	Callback used for device discovery.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  class Data {
    subscribeId: number = 0;
    device: deviceManager.DeviceInfo = {
      deviceId: "",
      deviceName: "",
      deviceType: 0,
      networkId: "",
      range: 0,
      authForm:0
    };
  }

  try {
    dmInstance.on('deviceFound', (data: Data) => {
      console.info("deviceFound:" + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("deviceFound errCode:" + e.code + ",errMessage:" + e.message);
  }

off(‘deviceFound’)

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

Unsubscribes from device discovery events.

NOTE
This API is deprecated since API version 11. Use off(‘discoverSuccess’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of deviceFound.
callback	Callback<{ subscribeId: number, device: DeviceInfo }>	No	Callback used to return the device information and state.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import deviceManager from '@ohos.distributedHardware.deviceManager';
  import { BusinessError } from '@ohos.base';

  class Data {
    subscribeId: number = 0;
    device: deviceManager.DeviceInfo = {
      deviceId: "",
      deviceName: "",
      deviceType: 0,
      networkId: "",
      range: 0,
      authForm:0
    };
  }

  try {
    dmInstance.off('deviceFound', (data: Data) => {
      console.info('deviceFound' + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("deviceFound errCode:" + e.code + ",errMessage:" + e.message);
  }

on(‘discoverFail’)

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

Subscribes to device discovery failures.

NOTE
This API is deprecated since API version 11. Use on(‘discoverFailure’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of discoverFail.
callback	Callback<{ subscribeId: number, reason: number }>	Yes	Callback used for the device discovery failure.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    subscribeId: number = 0;
    reason: number = 0;
  }

  try {
    dmInstance.on('discoverFail', (data: Data) => {
      console.info("discoverFail on:" + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("discoverFail errCode:" + e.code + ",errMessage:" + e.message);
  }

off(‘discoverFail’)

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

Unsubscribes from device discovery failures.

NOTE
This API is deprecated since API version 11. Use off(‘discoverFailure’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of discoverFail.
callback	Callback<{ subscribeId: number, reason: number }>	No	Callback used for the device discovery failure.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    subscribeId: number = 0;
    reason: number = 0;
  }

  try {
    dmInstance.off('discoverFail', (data: Data) => {
      console.info('discoverFail' + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("discoverFail errCode:" + e.code + ",errMessage:" + e.message);
  }

on(‘publishSuccess’)⁹⁺

on(type: ‘publishSuccess’, callback: Callback<{ publishId: number }>): void

Subscribes to device information publication success events.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of publishSuccess.
callback	Callback<{ publishId: number }>	Yes	Callback used to return the publish ID.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    publishId: number = 0;
  }

  try {
    dmInstance.on('publishSuccess', (data: Data) => {
      console.info("publishSuccess:" + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("publishSuccess errCode:" + e.code + ",errMessage:" + e.message);
  }

off(‘publishSuccess’)⁹⁺

off(type: ‘publishSuccess’, callback?: Callback<{ publishId: number }>): void

Unsubscribes from device information publication success events.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of publishSuccess.
callback	Callback<{ publishId: number }>	No	Callback used to return the publish ID.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    publishId: number = 0;
  }

  try {
    dmInstance.off('publishSuccess', (data: Data) => {
      console.info('publishSuccess' + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("publishSuccess errCode:" + e.code + ",errMessage:" + e.message);
  }

on(‘publishFail’)⁹⁺

on(type: ‘publishFail’, callback: Callback<{ publishId: number, reason: number }>): void

Subscribes to device information publication failures.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of publishFail.
callback	Callback<{ publishId: number, reason: number }>	Yes	Callback used for the publication failure.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    publishId: number = 0;
    reason: number = 0;
  }

  try {
    dmInstance.on('publishFail', (data: Data) => {
      console.info("publishFail on:" + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("publishFail errCode:" + e.code + ",errMessage:" + e.message);
  }

off(‘publishFail’)⁹⁺

off(type: ‘publishFail’, callback?: Callback<{ publishId: number, reason: number }>): void

Unsubscribes from device information publication failures.

NOTE
This API is deprecated since API version 11. There is no substitute API.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of publishFail.
callback	Callback<{ publishId: number, reason: number }>	No	Callback used for the device discovery failure.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  class Data {
    publishId: number = 0;
    reason: number = 0;
  }

  try {
    dmInstance.off('publishFail', (data: Data) => {
      console.info('publishFail' + JSON.stringify(data));
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("publishFail errCode:" + e.code + ",errMessage:" + e.message);
  }

on(‘serviceDie’)

on(type: ‘serviceDie’, callback: () => void): void

Subscribes to dead events of the DeviceManager service.

NOTE
This API is deprecated since API version 11. Use on(‘serviceDie’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of serviceDie.
callback	() => void	Yes	Callback invoked when a dead event of the DeviceManager service occurs.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  try {
    dmInstance.on("serviceDie", () => {
      console.info("serviceDie on");
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("serviceDie errCode:" + e.code + ",errMessage:" + e.message);
  }

off(‘serviceDie’)

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

Unsubscribes from dead events of the DeviceManager service.

NOTE
This API is deprecated since API version 11. Use off(‘serviceDie’) instead.

Required permissions: ohos.permission.ACCESS_SERVICE_DM

System capability: SystemCapability.DistributedHardware.DeviceManager

Parameters

Name	Type	Mandatory	Description
type	string	Yes	Event type, which has a fixed value of serviceDie.
callback	() => void	No	Callback used to return the dead event of the DeviceManager service.

Error codes

For details about the error codes, see Universal Error Codes.

ID	Error Message
202	Permission verification failed. A non-system application calls a system API.
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter type; 3. Parameter verification failed. 4. The size of specified eventType is greater than 255.

Example

For details about how to initialize dmInstance in the example, see deviceManager.createDeviceManager.

  import { BusinessError } from '@ohos.base';

  try {
    dmInstance.off("serviceDie", () => {
      console.info("serviceDie off");
    });
  } catch (err) {
    let e: BusinessError = err as BusinessError;
    console.error("serviceDie errCode:" + e.code + ",errMessage:" + e.message);
  }

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Distributed Service Kit (Distributed Management Service)

harmony 鸿蒙DeviceManager

harmony 鸿蒙oh_device_manager_err_code.h

harmony 鸿蒙oh_device_manager.h

harmony 鸿蒙Device Management Error Codes

harmony 鸿蒙Screen Hopping Error Codes

harmony 鸿蒙Link Enhancement Error Codes

harmony 鸿蒙@ohos.cooperate (Screen Hopping) (System API)

harmony 鸿蒙@ohos.distributedsched.abilityConnectionManager (Cross-Device Connection Management) (System API)

harmony 鸿蒙@ohos.distributedsched.abilityConnectionManager (Cross-Device Connection Management)

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/yytRg1

harmony 鸿蒙@ohos.distributedHardware.deviceManager (Device Management) (System API)

@ohos.distributedHardware.deviceManager (Device Management) (System API)

Modules to Import

deviceManager.createDeviceManager

DeviceInfo

DeviceType

AuthForm10+

DeviceStateChangeAction

SubscribeInfo

DiscoverMode

ExchangeMedium

ExchangeFreq

SubscribeCap

AuthParam

AuthInfo

PublishInfo9+

DeviceManager

release

getTrustedDeviceListSync

getTrustedDeviceListSync10+

getTrustedDeviceList8+

getTrustedDeviceList8+

getLocalDeviceInfoSync8+

getLocalDeviceInfo8+

getLocalDeviceInfo8+

getDeviceInfo10+

getDeviceInfo10+

startDeviceDiscovery8+

startDeviceDiscovery9+

stopDeviceDiscovery

publishDeviceDiscovery9+

unPublishDeviceDiscovery9+

authenticateDevice

unAuthenticateDevice8+

verifyAuthInfo

setUserOperation9+

requestCredentialRegisterInfo10+

importCredential10+

deleteCredential10+

on(‘uiStateChange’)9+

off(‘uiStateChange’)9+

on(‘deviceStateChange’)

off(‘deviceStateChange’)

on(‘deviceFound’)

off(‘deviceFound’)

on(‘discoverFail’)

off(‘discoverFail’)

on(‘publishSuccess’)9+

off(‘publishSuccess’)9+

on(‘publishFail’)9+

off(‘publishFail’)9+

on(‘serviceDie’)

off(‘serviceDie’)

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

AuthForm¹⁰⁺

PublishInfo⁹⁺

getTrustedDeviceListSync¹⁰⁺

getTrustedDeviceList⁸⁺

getTrustedDeviceList⁸⁺

getLocalDeviceInfoSync⁸⁺

getLocalDeviceInfo⁸⁺

getLocalDeviceInfo⁸⁺

getDeviceInfo¹⁰⁺

getDeviceInfo¹⁰⁺

startDeviceDiscovery⁸⁺

startDeviceDiscovery⁹⁺

publishDeviceDiscovery⁹⁺

unPublishDeviceDiscovery⁹⁺

unAuthenticateDevice⁸⁺

setUserOperation⁹⁺

requestCredentialRegisterInfo¹⁰⁺

importCredential¹⁰⁺

deleteCredential¹⁰⁺

on(‘uiStateChange’)⁹⁺

off(‘uiStateChange’)⁹⁺

on(‘publishSuccess’)⁹⁺

off(‘publishSuccess’)⁹⁺

on(‘publishFail’)⁹⁺

off(‘publishFail’)⁹⁺