鸿蒙开发设备管理:【@ohos.distributedHardware.deviceManager (设备管理)】

设备管理

本模块提供分布式设备管理能力。

系统应用可调用接口实现如下功能:

  • 注册和解除注册设备上下线变化监听
  • 发现周边不可信设备
  • 认证和取消认证设备
  • 查询可信设备列表
  • 查询本地设备信息,包括设备名称,设备类型和设备标识

icon-note.gif 说明:

  • 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
  • 本模块接口为系统接口,三方应用不支持调用。

导入模块

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

deviceManager.createDeviceManager

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

创建一个设备管理器实例。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    参数名类型必填说明
    bundleNamestring指示应用程序的包名。
    callbackAsyncCallback<[DeviceManager]>DeviceManager实例创建时调用的回调,返回设备管理器对象实例。
  • 示例:

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

DeviceInfo

设备信息。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称类型必填描述
deviceIdstring设备的唯一标识。
deviceNamestring设备名称。
deviceType[DeviceType]设备类型。
networkId8+string设备网络标识。

DeviceType

表示设备类型的枚举类。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称默认值说明
SPEAKER0x0A智能音箱
PHONE0x0E手机
TABLET0x11平板
WEARABLE0x6D智能穿戴
TV0x9C智慧屏
CAR0x83
UNKNOWN_TYPE0未知设备

DeviceStateChangeAction

表示设备状态变化的枚举。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称默认值说明
ONLINE0设备上线。
READY1设备就绪,设备信息同步已完成。
OFFLINE2设备下线。
CHANGE3设备信息更改。

SubscribeInfo

发现信息。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称类型必填描述
subscribeIdnumber发现标识,用于标识不同的发现周期。
mode[DiscoverMode]发现模式。
medium[ExchangeMedium]发现类型。
freq[ExchangeFreq]发现频率。
isSameAccountboolean是否同账号。
isWakeRemoteboolean是否唤醒设备。
capability[SubscribeCap]发现能力。

DiscoverMode

表示发现模式的枚举。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称默认值说明
DISCOVER_MODE_PASSIVE0x55被动模式。
DISCOVER_MODE_ACTIVE0xAA主动模式。

ExchangeMedium

表示发现类型的枚举。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称默认值说明
AUTO0自动发现类型。
BLE1蓝牙发现类型。
COAP2WiFi发现类型。
USB3USB发现类型。

ExchangeFreq

表示发现频率的枚举。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称默认值说明
LOW0低频率。
MID1中频率。
HIGH2高频率。
SUPER_HIGH3超高频率。

SubscribeCap

表示发现能力的枚举。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称默认值说明
SUBSCRIBE_CAPABILITY_DDMP0DDMP能力,后续会被废弃。
SUBSCRIBE_CAPABILITY_OSD1OSD能力。

AuthParam

认证参数。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称类型必填描述
authTypenumber认证类型。
extraInfo{[key:string] : any}认证参数可扩展字段。

AuthInfo

认证信息。

系统能力:以下各项对应的系统能力均为SystemCapability.DistributedHardware.DeviceManager

名称类型必填描述
authTypenumber认证类型。
tokennumber认证Token。
extraInfo{[key:string] : any}认证信息可扩展字段。

DeviceManager

设备管理实例,用于获取可信设备和本地设备的相关信息。在调用DeviceManager的方法前,需要先通过createDeviceManager构建一个DeviceManager实例dmInstance。

release

release(): void

设备管理实例不再使用后,通过该方法释放DeviceManager实例。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 示例:

    dmInstance.release();
    

getTrustedDeviceListSync

getTrustedDeviceListSync(): Array

同步获取所有可信设备列表。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 返回值:

    名称说明
    Array<[DeviceInfo]>返回可信设备列表。
  • 示例:

    var deviceInfoList = dmInstance.getTrustedDeviceListSync();
    

getTrustedDeviceList8+

getTrustedDeviceList(callback:AsyncCallback<Array>): void

获取所有可信设备列表。使用callback异步回调。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    callbackAsyncCallback<Array<[DeviceInfo]>>获取所有可信设备列表的回调,返回设备信息。
  • 示例:

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

getTrustedDeviceList8+

getTrustedDeviceList(): Promise<Array>

获取所有可信设备列表。使用Promise异步回调。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 返回值:

    类型说明
    Promise<Array<[DeviceInfo]>>Promise实例,用于获取异步返回结果。
  • 示例:

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

getLocalDeviceInfoSync8+

getLocalDeviceInfoSync(): [DeviceInfo]

同步获取本地设备信息。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 返回值:

    名称说明
    Array<[DeviceInfo]>返回可信设备列表。
  • 示例:

    var deviceInfo = dmInstance.getLocalDeviceInfoSync();
    

getLocalDeviceInfo8+

getLocalDeviceInfo(callback:AsyncCallback): void

获取本地设备信息。使用callback异步回调。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    callbackAsyncCallback<[DeviceInfo]>获取本地设备信息。
  • 示例:

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

getLocalDeviceInfo8+

getLocalDeviceInfo(): Promise

获取本地设备信息。使用Promise异步回调。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 返回值:

    类型说明
    Promise<[DeviceInfo]>Promise实例,用于获取异步返回结果。
  • 示例:

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

startDeviceDiscovery

startDeviceDiscovery(subscribeInfo: SubscribeInfo): void

发现周边设备。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    subscribeInfo[SubscribeInfo]发现信息。
  • 示例:

    //生成发现标识,随机数确保每次调用发现接口的标识不一致
    var subscribeId = Math.floor(Math.random() * 10000 + 1000);
    var subscribeInfo = {"subscribeId": subscribeId,"mode": 0xAA, //主动模式"medium": 0,  //自动发现类型,同时支持多种发现类型"freq": 2,    //高频率"isSameAccount": false,"isWakeRemote": false,"capability": 1
    };
    dmInstance.startDeviceDiscovery(subscribeInfo); //当有设备发现时,通过deviceFound回调通知给应用程序
    

stopDeviceDiscovery

stopDeviceDiscovery(subscribeId: number): void

停止发现周边设备。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    subscribeIdnumber发现标识。
  • 示例:

    //入参需要和startDeviceDiscovery接口传入的subscribeId配对使用
    dmInstance.stopDeviceDiscovery(subscribeId);
    

authenticateDevice

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

认证设备。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    deviceInfo[DeviceInfo]设备信息。
    authParam[AuthParam]认证参数。
    callbackAsyncCallback<{ deviceId: string, pinToken ?: number }>认证结果回调。
  • 示例:

    //认证的设备信息,可以从发现的结果中获取
    var deviceInfo ={"deviceId": "XXXXXXXX","deviceName": "",deviceType: 0x0E
    };
    let authParam = {"authType": 1, //认证类型: 1 - 无账号PIN码认证"extraInfo": {} 
    }
    dmInstance.authenticateDevice(deviceInfo, authParam, (err, data) => {if (err) {console.info(TAG + "authenticateDevice err:" + JSON.stringify(err));return;}console.info(TAG + "authenticateDevice result:" + JSON.stringify(data));token = data.pinToken;
    });
    

unAuthenticateDevice8+

unAuthenticateDevice(deviceInfo: DeviceInfo): void

解除认证设备。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    deviceInfo[DeviceInfo]设备信息。
  • 示例:

    dmInstance.unAuthenticateDevice(deviceInfo);
    

verifyAuthInfo

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

验证认证信息。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    authInfo[AuthInfo]认证信息。
    authInfoAsyncCallback<{ deviceId: string, level: number }>验证结果回调。
  • 示例:

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

on(‘deviceStateChange’)

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

注册设备状态回调。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    typestring注册设备状态回调,固定为deviceStateChange。
    callbackCallback<{ action: [DeviceStateChangeAction], device: [DeviceInfo] }>指示要注册的设备状态回调,返回设备状态和设备信息。
  • 示例:

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

off(‘deviceStateChange’)

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

取消注册设备状态回调。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    typestring根据应用程序的包名取消注册设备状态回调。
    callbackCallback<{ action: [DeviceStateChangeAction], device: [DeviceInfo] }>指示要取消注册的设备状态回调,返回设备状态和设备信息。
  • 示例:

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

on(‘deviceFound’)

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

注册发现设备回调监听。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    typestring注册设备发现回调,以便在发现周边设备时通知应用程序。
    callbackCallback<{ subscribeId: number, device: DeviceInfo }>注册设备发现的回调方法。
  • 示例:

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

off(‘deviceFound’)

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

取消注册设备发现回调。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    typestring取消注册设备发现回调。
    callbackCallback<{ subscribeId: number, device: DeviceInfo }>指示要取消注册的设备发现回调,返回设备状态和设备信息。
  • 示例:

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

on(‘discoverFail’)

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

注册设备发现失败回调监听。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    typestring注册设备发现失败回调,以便在发现周边设备失败时通知应用程序。
    callbackCallback<{ subscribeId: number, reason: number }>注册设备发现失败的回调方法。
  • 示例:

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

off(‘discoverFail’)

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

取消注册设备发现失败回调。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    typestring取消注册设备发现失败回调。
    callbackCallback<{ subscribeId: number, reason: number }>指示要取消注册的设备发现失败回调。
  • 示例:

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

on(‘serviceDie’)

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

注册设备管理服务死亡监听。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    typestring注册serviceDie回调,以便在devicemanager服务异常终止时通知应用程序。
    callback() => void注册serviceDie的回调方法。
  • 示例:

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

off(‘serviceDie’)

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

取消注册设备管理服务死亡监听。

系统能力:SystemCapability.DistributedHardware.DeviceManager

  • 参数:

    名称参数类型必填说明
    typestring取消注册serviceDie回调,以便在devicemanager服务异常终止时通知应用程序。
    callback() => void取消注册serviceDie的回调方法。

在这里插入图片描述

  • 示例:

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

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/862952.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

IIC学习笔记(立创STMF4开发板)

目录 #I2C涉及相关知识 #I2C相关介绍 欢迎指正&#xff0c;希望对你&#xff0c;有所帮助&#xff01;&#xff01;&#xff01; 个人学习笔记&#xff0c;参考文献&#xff0c;链接最后&#xff01;&#xff01;&#xff01; #I2C涉及相关知识 SDA串行数据线&#xff1a; Ser…

昇思25天学习打卡营第11天|基于MindSpore通过GPT实现情感分类

学AI还能赢奖品&#xff1f;每天30分钟&#xff0c;25天打通AI任督二脉 (qq.com) 基于MindSpore通过GPT实现情感分类 %%capture captured_output # 实验环境已经预装了mindspore2.2.14&#xff0c;如需更换mindspore版本&#xff0c;可更改下面mindspore的版本号 !pip uninsta…

java基于微信小程序+mysql+RocketMQ开发的医院智能问诊系统源码 智能导诊系统 智能导诊小程序源码

java基于微信小程序mysqlRocketMQ开发的医院智能问诊系统源码 智能导诊系统 智能导诊小程序源码 医院导诊系统是一种基于互联网和定位技术的智能化服务系统&#xff0c;旨在为患者提供精准、便捷的医院内部导航和医疗就诊咨询服务。该系统整合了医院的各种医疗服务资源&#x…

【软件实施】软件实施概论

目录 软件实施概述定义主要工作软件项目的实施工作区别于一般的项目&#xff08;如&#xff1a;房地产工程项目&#xff09;软件实施的重要性挑战与对策软件项目实施的流程软件项目实施的周期 软件企业软件企业分类产品型软件企业业务特点产品型软件企业的分类产品型软件企业的…

PortSip测试

安装PBX 下载 免费下载 PortSIP PBX 安装PBX&#xff0c;安装后&#xff0c;运行 &#xff0c;默认用户是admin 密码是admin&#xff0c;然后配置IP 为192.168.0.189 设置域名为192.168.0.189 配置分机 添加分机&#xff0c;添加了10001、10002、9999 三个分机&#xff0c…

10分钟完成微信JSAPI支付对接过程-JAVA后端接口

引入架包 <dependency><groupId>com.github.javen205</groupId><artifactId>IJPay-WxPay</artifactId><version>${ijapy.version}</version></dependency>配置类 package com.joolun.web.config;import org.springframework.b…

【递归、搜索与回溯】记忆化搜索

记忆化搜索 1.记忆化搜索2.不同路径3.最长递增子序列4. 猜数字大小 II5.矩阵中的最长递增路径 点赞&#x1f44d;&#x1f44d;收藏&#x1f31f;&#x1f31f;关注&#x1f496;&#x1f496; 你的支持是对我最大的鼓励&#xff0c;我们一起努力吧!&#x1f603;&#x1f603;…

5000字深入讲解:企业数字化转型优先从哪个板块开始?

很多企业都知道数字化转型重要&#xff0c;但不知道应该怎样入手&#xff0c;分哪些阶段。以下引用国内领先数字化服务商 织信Informat 的数字化转型方法论材料&#xff0c;且看看他们是如何看待数字化转型的&#xff1f;数字化转型应该从哪先开始&#xff1f;如何做&#xff1…

P1107 [BJWC2008] 雷涛的小猫

[BJWC2008] 雷涛的小猫 题目背景 原最大整数参见 P1012 题目描述 雷涛同学非常的有爱心&#xff0c;在他的宿舍里&#xff0c;养着一只因为受伤被救助的小猫&#xff08;当然&#xff0c;这样的行为是违反学生宿舍管理条例的&#xff09;。在他的照顾下&#xff0c;小猫很快…

阿里云服务器数据库迁云: 数据从传统到云端的安全之旅(WordPress个人博客实战教学)

&#x1f3ac; 鸽芷咕&#xff1a;个人主页 &#x1f525; 个人专栏: 《C干货基地》《粉丝福利》 ⛺️生活的理想&#xff0c;就是为了理想的生活! 文章目录 一、 开始实战1.2创建实验资源1.3重置云服务器ECS的登录密码&#xff08;请记住密码&#xff09;1.4 设置安全组端口1…

Adobe Acrobat Pro或者Adobe Acrobat Reader取消多标签页显示,设置打开一个pdf文件对应一个窗口。

Windows系统&#xff1a;Adobe Acrobat Pro或者Adobe Acrobat Reader首选项-一般-取消在同一窗口的新标签中打开文档&#xff08;需要重启&#xff09;的对勾&#xff0c;点击确定&#xff0c;彻底关闭后重启&#xff0c;这样打开的每一个PDF文件对应的是一个窗口&#xff0c;并…

Bridging nonnull in Objective-C to Swift: Is It Safe?

Bridging nonnull in Objective-C to Swift: Is It Safe? In the world of iOS development, bridging between Objective-C and Swift is a common practice, especially for legacy codebases (遗留代码库) or when integrating (集成) third-party libraries. One importa…

重磅更新-UniApp自定义字体可视化设计

重磅更新-UniApp自定义字体可视化设计。 DIY可视化为了适配不同APP需要&#xff0c;支持用户自定义字体&#xff0c;自定义字体后&#xff0c;设计出来的界面更多样化&#xff0c;不再是单一字体效果。用户可以使用第三方字体加入设计&#xff0c;在设计的时候选择上自己的字体…

AI副业赚钱攻略:掌握数字时代的机会

前言 最近国产大模型纷纷上线&#xff0c;飞入寻常百姓家。AI副业正成为许多人寻找额外收入的途径。无论您是想提高家庭收入还是寻求职业发展&#xff0c;这里有一个变现&#xff0c;帮助您掌握AI兼职副业的机会。 1. 了解AI的基础知识 在开始之前&#xff0c;了解AI的基础…

一个开源的、独立的、可自托管的评论系统,专为现代Web平台设计

大家好&#xff0c;今天给大家分享的是一个开源的、独立的、可自托管的评论系统&#xff0c;专为现代Web平台设计。 Remark42是一个自托管的、轻量级的、简单的&#xff08;但功能强大的&#xff09;评论引擎&#xff0c;它不会监视用户。它可以嵌入到博客、文章或任何其他读者…

kafka-Stream详解篇(附案例)

文章目录 Kafka Stream 概述Kafka Stream 概念Kafka Stream 数据结构入门案例一需求描述与分析配置KafkaStream定义处理流程声明Topic接收处理结果发送消息测试 入门案例二需求描述与分析定义处理流程接收处理结果声明Topic 更多相关内容可查看 Kafka Stream 概述 Kafka Strea…

深入理解linux shell 中的exec内置命令ubuntu bash

概览 每当我们在Bash shell 中运行任何命令时&#xff0c;默认情况下都会创建一个子 shell&#xff0c;并生成&#xff08;分叉&#xff09;一个新的子进程来执行该命令。但是&#xff0c;当使用 exec时&#xff0c;exec 后面的命令将替换当前 shell。这意味着不会创建任何子 …

【高中数学之基本不等式】已知:x,y皆为正实数且x+3y=5xy,求3x+4y的最小值?

解&#xff1a;此题若使用“化二为一”法&#xff0c;会发现分母中出现了5x-3或是5y-1这样的式子&#xff0c;它可能导致负数的出现&#xff0c;已经违反了基本不等式中a,b皆大于零的应用条件。 此时应该迷途知返&#xff0c;及时易辙改弦。 此题适用“乘一法”&#xff0c;这…

第1章_搭建开发环境

文章目录 第1章 搭建开发环境1.1开发套件硬件接口资源介绍1.2资料下载1.3安装Keil MDK1.3.1**软件下载**1.3.2**软件安装**1.3.3 PACK 安装 1.4 安装 STM32CubeMX1.5 安装 STM32CubeProgrammer1.6 安装 ST-Link 驱动1.7 安装 CH340 驱动 第1章 搭建开发环境 1.1开发套件硬件接…

Redis基础教程(一):redis配置

&#x1f49d;&#x1f49d;&#x1f49d;首先&#xff0c;欢迎各位来到我的博客&#xff0c;很高兴能够在这里和您见面&#xff01;希望您在这里不仅可以有所收获&#xff0c;同时也能感受到一份轻松欢乐的氛围&#xff0c;祝你生活愉快&#xff01; &#x1f49d;&#x1f49…