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