diff --git a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md
index 9e00ebc9246a773e58de2f7d10c7dfbcbe0086b0..a6f6fa765108af8a4db7b5b195fbe0bd9f678654 100644
--- a/zh-cn/application-dev/reference/apis/js-apis-device-manager.md
+++ b/zh-cn/application-dev/reference/apis/js-apis-device-manager.md
@@ -22,7 +22,7 @@
## 导入模块
-```
+```js
import deviceManager from '@ohos.distributedHardware.deviceManager';
```
@@ -42,15 +42,19 @@ createDeviceManager(bundleName: string, callback: AsyncCallback<DeviceManager
| callback | AsyncCallback<[DeviceManager](#devicemanager)> | 是 | DeviceManager实例创建时调用的回调,返回设备管理器对象实例。 |
- 示例:
- ```
- deviceManager.createDeviceManager("ohos.samples.jshelloworld", (err, data) => {
+ ```js
+ try {
+ deviceManager.createDeviceManager("ohos.samples.jshelloworld", (err, data) => {
if (err) {
- console.info("createDeviceManager err:" + JSON.stringify(err));
- return;
+ console.error("createDeviceManager errCode:" + err.code + ",errMessage:" + err.message);
+ return;
}
console.info("createDeviceManager success");
let dmInstance = data;
- });
+ });
+ } catch(err) {
+ console.error("createDeviceManager errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
## DeviceInfo
@@ -216,7 +220,11 @@ release(): void
- 示例:
```js
- dmInstance.release();
+ try {
+ dmInstance.release();
+ } catch (err) {
+ console.error("release errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
@@ -235,7 +243,11 @@ getTrustedDeviceListSync(): Array<DeviceInfo>
- 示例:
```js
- var deviceInfoList = dmInstance.getTrustedDeviceListSync();
+ try {
+ var deviceInfoList = dmInstance.getTrustedDeviceListSync();
+ } catch (err) {
+ console.error("getTrustedDeviceListSync errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
@@ -254,11 +266,17 @@ getTrustedDeviceList(callback:AsyncCallback<Array<DeviceInfo>>): voi
- 示例:
```js
- dmInstance.getTrustedDeviceList((err, data) => {
- console.log("getTrustedDeviceList err: " + JSON.stringify(err));
+ try {
+ dmInstance.getTrustedDeviceList((err, data) => {
+ if (err) {
+ console.error("getTrustedDeviceList errCode:" + err.code + ",errMessage:" + err.message);
+ return;
+ }
console.log('get trusted device info: ' + JSON.stringify(data));
- }
- );
+ });
+ } catch (err) {
+ console.error("getTrustedDeviceList errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### getTrustedDeviceList8+
@@ -276,11 +294,15 @@ getTrustedDeviceList(): Promise<Array<DeviceInfo>>
- 示例:
```js
- dmInstance.getTrustedDeviceList().then((data) => {
+ try {
+ dmInstance.getTrustedDeviceList().then((data) => {
console.log('get trusted device info: ' + JSON.stringify(data));
- }).catch((err) => {
- console.log("getTrustedDeviceList err: " + JSON.stringify(err));
- });
+ }).catch((err) => {
+ console.error("getTrustedDeviceList errCode:" + err.code + ",errMessage:" + err.message);
+ });
+ } catch (err) {
+ console.error("getTrustedDeviceList errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### getLocalDeviceInfoSync8+
@@ -298,7 +320,11 @@ getLocalDeviceInfoSync(): [DeviceInfo](#deviceinfo)
- 示例:
```js
- var deviceInfo = dmInstance.getLocalDeviceInfoSync();
+ try {
+ var deviceInfo = dmInstance.getLocalDeviceInfoSync();
+ } catch (err) {
+ console.error("getLocalDeviceInfoSync errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
@@ -317,11 +343,17 @@ getLocalDeviceInfo(callback:AsyncCallback<DeviceInfo>): void
- 示例:
```js
- dmInstance.getLocalDeviceInfo((err, data) => {
- console.log("getLocalDeviceInfo err: " + JSON.stringify(err));
- console.log('get local device info: ' + JSON.stringify(data));
+ try {
+ dmInstance.getLocalDeviceInfo((err, data) => {
+ if (err) {
+ console.error("getLocalDeviceInfo errCode:" + err.code + ",errMessage:" + err.message);
+ return;
}
- );
+ console.log('get local device info: ' + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("getLocalDeviceInfo errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### getLocalDeviceInfo8+
@@ -339,11 +371,15 @@ getLocalDeviceInfo(): Promise<DeviceInfo>
- 示例:
```js
- dmInstance.getLocalDeviceInfo().then((data) => {
+ try {
+ dmInstance.getLocalDeviceInfo().then((data) => {
console.log('get local device info: ' + JSON.stringify(data));
- }).catch((err) => {
- console.log("getLocalDeviceInfo err: " + JSON.stringify(err));
- });
+ }).catch((err) => {
+ console.error("getLocalDeviceInfo errCode:" + err.code + ",errMessage:" + err.message);
+ });
+ } catch (err) {
+ console.error("getLocalDeviceInfo errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### startDeviceDiscovery8+
@@ -372,7 +408,11 @@ startDeviceDiscovery(subscribeInfo: SubscribeInfo): void
"isWakeRemote": false,
"capability": 1
};
- dmInstance.startDeviceDiscovery(subscribeInfo); // 当有设备发现时,通过deviceFound回调通知给应用程序
+ try {
+ dmInstance.startDeviceDiscovery(subscribeInfo); // 当有设备发现时,通过deviceFound回调通知给应用程序
+ } catch (err) {
+ console.error("startDeviceDiscovery errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### startDeviceDiscovery9+
@@ -411,7 +451,11 @@ startDeviceDiscovery(subscribeInfo: SubscribeInfo, filterOptions?: string): void
}
]
};
- dmInstance.startDeviceDiscovery(subscribeInfo, JSON.stringify(filterOptions)); // 当有设备发现时,通过deviceFound回调通知给应用程序
+ try {
+ dmInstance.startDeviceDiscovery(subscribeInfo, JSON.stringify(filterOptions)); // 当有设备发现时,通过deviceFound回调通知给应用程序
+ } catch (err) {
+ console.error("startDeviceDiscovery errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### stopDeviceDiscovery
@@ -430,7 +474,11 @@ stopDeviceDiscovery(subscribeId: number): void
- 示例:
```js
// 入参需要和startDeviceDiscovery接口传入的subscribeId配对使用
- dmInstance.stopDeviceDiscovery(subscribeId);
+ try {
+ dmInstance.stopDeviceDiscovery(subscribeId);
+ } catch (err) {
+ console.error("stopDeviceDiscovery errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### publishDeviceDiscovery9+
@@ -456,7 +504,11 @@ publishDeviceDiscovery(publishInfo: PublishInfo): void
"freq": 2, // 高频率
"ranging": 1 // 支持发现时测距
};
- dmInstance.publishDeviceDiscovery(publishInfo); // 当有发布结果时,通过回调通知给应用程序
+ try {
+ dmInstance.publishDeviceDiscovery(publishInfo); // 当有发布结果时,通过回调通知给应用程序
+ } catch (err) {
+ console.error("publishDeviceDiscovery errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### unPublishDeviceDiscovery9+
@@ -475,7 +527,11 @@ unPublishDeviceDiscovery(publishId: number): void
- 示例:
```js
// 入参需要和publishDeviceDiscovery接口传入的publishId配对使用
- dmInstance.unPublishDeviceDiscovery(publishId);
+ try {
+ dmInstance.unPublishDeviceDiscovery(publishId);
+ } catch (err) {
+ console.error("unPublishDeviceDiscovery errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### authenticateDevice
@@ -505,14 +561,18 @@ authenticateDevice(deviceInfo: DeviceInfo, authParam: AuthParam, callback: Async
"authType": 1, // 认证类型: 1 - 无账号PIN码认证
"extraInfo": {}
}
- dmInstance.authenticateDevice(deviceInfo, authParam, (err, data) => {
+ try {
+ dmInstance.authenticateDevice(deviceInfo, authParam, (err, data) => {
if (err) {
- console.info(TAG + "authenticateDevice err:" + JSON.stringify(err));
+ console.error("authenticateDevice errCode:" + err.code + ",errMessage:" + err.message);
return;
}
console.info(TAG + "authenticateDevice result:" + JSON.stringify(data));
token = data.pinToken;
- });
+ });
+ } catch (err) {
+ console.error("authenticateDevice errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### unAuthenticateDevice8+
@@ -530,7 +590,11 @@ unAuthenticateDevice(deviceInfo: DeviceInfo): void
- 示例:
```js
- dmInstance.unAuthenticateDevice(deviceInfo);
+ try {
+ dmInstance.unAuthenticateDevice(deviceInfo);
+ } catch (err) {
+ console.error("unAuthenticateDevice errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
@@ -555,13 +619,17 @@ verifyAuthInfo(authInfo: AuthInfo, callback: AsyncCallback<{deviceId: string, le
"token": xxxxxx,
"extraInfo": {}
}
- dmInstance.verifyAuthInfo(authInfo, (err, data) => {
+ try {
+ dmInstance.verifyAuthInfo(authInfo, (err, data) => {
if (err) {
- console.info(TAG + "verifyAuthInfo err:" + JSON.stringify(err));
+ console.error("verifyAuthInfo errCode:" + err.code + ",errMessage:" + err.message);
return;
}
console.info(TAG + "verifyAuthInfo result:" + JSON.stringify(data));
- });
+ });
+ } catch (err) {
+ console.error("verifyAuthInfo errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
@@ -581,10 +649,13 @@ on(type: 'deviceStateChange', callback: Callback<{ action: DeviceStateChange
- 示例:
```js
- dmInstance.on('deviceStateChange', (data) => {
- console.info("deviceStateChange on:" + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.on('deviceStateChange', (data) => {
+ console.info("deviceStateChange on:" + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("deviceStateChange errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
@@ -604,10 +675,13 @@ off(type: 'deviceStateChange', callback?: Callback<{ action: DeviceStateChang
- 示例:
```js
- dmInstance.off('deviceStateChange', (data) => {
- console.info('deviceStateChange' + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.off('deviceStateChange', (data) => {
+ console.info('deviceStateChange' + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("deviceStateChange errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
@@ -627,10 +701,13 @@ on(type: 'deviceFound', callback: Callback<{ subscribeId: number, device: Dev
- 示例:
```js
- dmInstance.on('deviceFound', (data) => {
- console.info("deviceFound:" + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.on('deviceFound', (data) => {
+ console.info("deviceFound:" + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("deviceFound errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### off('deviceFound')
@@ -649,10 +726,13 @@ off(type: 'deviceFound', callback?: Callback<{ subscribeId: number, device: D
- 示例:
```js
- dmInstance.off('deviceFound', (data) => {
- console.info('deviceFound' + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.off('deviceFound', (data) => {
+ console.info('deviceFound' + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("deviceFound errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### on('discoverFail')
@@ -671,10 +751,13 @@ on(type: 'discoverFail', callback: Callback<{ subscribeId: number, reason: nu
- 示例:
```js
- dmInstance.on('discoverFail', (data) => {
- this.log("discoverFail on:" + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.on('discoverFail', (data) => {
+ console.info("discoverFail on:" + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("discoverFail errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### off('discoverFail')
@@ -693,10 +776,13 @@ off(type: 'discoverFail', callback?: Callback<{ subscribeId: number, reason:
- 示例:
```js
- dmInstance.off('deviceFound', (data) => {
- console.info('deviceFound' + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.off('discoverFail', (data) => {
+ console.info('discoverFail' + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("discoverFail errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### on('publishSuccess')9+
@@ -715,10 +801,13 @@ on(type: 'publishSuccess', callback: Callback<{ publishId: number }>): voi
- 示例:
```js
- dmInstance.on('publishSuccess', (data) => {
- console.info("publishSuccess:" + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.on('publishSuccess', (data) => {
+ console.info("publishSuccess:" + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("publishSuccess errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### off('publishSuccess')9+
@@ -737,10 +826,13 @@ off(type: 'publishSuccess', callback?: Callback<{ publishId: number }>): v
- 示例:
```js
- dmInstance.off('publishSuccess', (data) => {
- console.info('publishSuccess' + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.off('publishSuccess', (data) => {
+ console.info('publishSuccess' + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("publishSuccess errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### on('publishFail')9+
@@ -759,10 +851,13 @@ on(type: 'publishFail', callback: Callback<{ publishId: number, reason: numbe
- 示例:
```js
- dmInstance.on('publishFail', (data) => {
- this.log("publishFail on:" + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.on('publishFail', (data) => {
+ console.info("publishFail on:" + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("publishFail errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### off('publishFail')9+
@@ -781,10 +876,13 @@ off(type: 'publishFail', callback?: Callback<{ publishId: number, reason: num
- 示例:
```js
- dmInstance.off('publishFail', (data) => {
- console.info('publishFail' + JSON.stringify(data));
- }
- );
+ try {
+ dmInstance.off('publishFail', (data) => {
+ console.info('publishFail' + JSON.stringify(data));
+ });
+ } catch (err) {
+ console.error("publishFail errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
### on('serviceDie')
@@ -803,10 +901,13 @@ on(type: 'serviceDie', callback: () => void): void
- 示例:
```js
- dmInstance.on("serviceDie", () => {
- console.info("serviceDie on");
- }
- );
+ try {
+ dmInstance.on("serviceDie", () => {
+ console.info("serviceDie on");
+ });
+ } catch (err) {
+ console.error("serviceDie errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
@@ -826,8 +927,11 @@ off(type: 'serviceDie', callback?: () => void): void
- 示例:
```js
- dmInstance.off("serviceDie", () => {
- console.info("serviceDie off");
- }
- );
+ try {
+ dmInstance.off("serviceDie", () => {
+ console.info("serviceDie off");
+ });
+ } catch (err) {
+ console.error("serviceDie errCode:" + err.code + ",errMessage:" + err.message);
+ }
```
\ No newline at end of file