Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
7ebb225e
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
7ebb225e
编写于
7月 03, 2023
作者:
D
dongbinbin
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add guideline.
Signed-off-by:
N
dongbinbin
<
dongbinbin@huawei.com
>
上级
6f4e1346
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
105 addition
and
0 deletion
+105
-0
zh-cn/application-dev/device/externaldevice-guidelines.md
zh-cn/application-dev/device/externaldevice-guidelines.md
+105
-0
未找到文件。
zh-cn/application-dev/device/externaldevice-guidelines.md
0 → 100644
浏览文件 @
7ebb225e
# 扩展外设管理开发指南
## 场景介绍
扩展外设主要是指通过物理接口连入主设备的配件设备,如手写板、打印机和高拍仪等。应用通过扩展外设管理能力可以查询绑定扩展外设,从而使用扩展外设驱动提供的定制能力来使用扩展外设,如打印机的配套软件。
## 接口说明
扩展外设管理主要提供的功能有:查询扩展外设列表、绑定和解绑查询到的设备。
扩展外设管理开放能力如下,具体请查阅
[
API参考文档
](
../reference/apis/js-apis-driver-deviceManager.md
)
。
**表1**
扩展外设管理开放能力接口
| 接口名 | 描述 |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| queryDevices(busType?: number): Array
<
Readonly
<
Device
>>
| 查询扩展外设列表 |
| bindDevice(deviceId: number, onDisconnect: AsyncCallback
<
number
>
, callback: AsyncCallback
<
{deviceId: number, remote: rpc.IRemoteObject}
>
): void | 绑定设备,绑定成功后返回设备驱动的IRemoteObject通信对象,通过该对象与设备驱动进行交互。 |
| bindDevice(deviceId: number, onDisconnect: AsyncCallback
<
number
>
): Promise
<
{deviceId: number, remote: rpc.IRemoteObject}
>
| 绑定设备的Promise形式。 |
| unbindDevice(deviceId: number, callback: AsyncCallback
<
number
>
): void | 解绑设备。 |
| unbindDevice(deviceId: number): Promise
<
number
>
| 解绑设备的Promise形式。 |
## 开发步骤
应用可通过查询绑定扩展外设,从而使用扩展外设的定制驱动能力。开发示例如下:
1.
查询设备列表。
```
js
var
matchDevice
;
try
{
let
devices
=
deviceManager
.
queryDevices
(
deviceManager
.
BusType
.
USB
);
for
(
let
item
of
devices
)
{
let
device
=
item
as
deviceManager
.
USBDevice
;
// 通过productId和vendorId来匹配要使用的USB设备
if
(
device
.
productId
==
1234
&&
device
.
vendorId
===
2345
)
{
matchDevice
=
device
;
break
;
}
}
}
catch
(
error
)
{
console
.
error
(
'
Failed to query device. Code is ${error.code}, message is ${error.message}
'
);
}
if
(
!
matchDevice
)
{
console
.
error
(
'
No match device
'
);
return
;
}
```
2.
绑定相应的设备。
```
js
var
remoteObject
;
try
{
deviceManager
.
bindDevice
(
matchDevice
.
deviceId
,
(
error
,
data
)
=>
{
console
.
error
(
'
Device is disconnected
'
);
},
(
error
,
data
)
=>
{
if
(
error
)
{
console
.
error
(
'
bindDevice async fail. Code is ${error.code}, message is ${error.message}
'
);
return
;
}
console
.
info
(
'
bindDevice success
'
);
remoteObject
=
data
.
remote
;
});
}
catch
(
error
)
{
console
.
error
(
'
bindDevice fail. Code is ${error.code}, message is ${error.message}
'
);
}
```
3. 绑定成功后使用设备驱动能力。
```
js
let option = new rpc.MessageOption();
let data = rpc.MessageSequence.create();
let repy = rpc.MessageSequence.create();
data.writeString('hello');
let code = 1;
// code和data内容取决于驱动提供的接口
remoteObject.sendMessageRequest(code, data, reply, option)
.then(result => {
console.info('sendMessageRequest finish.');
}).catch(error => {
console.error('sendMessageRequest fail. code:' + error.code);
});
```
4. 设备使用完成,解绑设备。
```
js
try {
deviceManager.unbindDevice(matchDevice.deviceId, (error, data) => {
if (error) {
console.error('unbindDevice async fail. Code is ${error.code}, message is ${error.message}');
return;
}
console.info('unbindDevice success');
});
} catch (error) {
console.error('unbindDevice fail. Code is ${error.code}, message is ${error.message}');
}
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录