【FFH】(OpenHarmony)小熊派BearPi开发板北向添加JS自定义接口流程(以点亮LED为例)
引言
通常我们做鸿蒙北向应用开发的时候是没法调用开发环境中未提供的接口的,而我们也知道鸿蒙开发是分北向和南向的,那么我们如何才能调用南向写好的设备驱动呢?
这里我们就用一个小熊派开发板控制LED的案例
来了解一下,南向那边写好LED驱动后,他们还会自定义一个JS的API接口
去调用他们开发好的LED灯驱动,这一部分称为系统定义接口
。具体南向怎么开发驱动,怎么完成系统定义接口的可以看看另外一位同学的文章:
【FFH】小熊派添加自定义JS API接口流程(以点亮LED为例)
而我们北向是不能直接调用非环境自带的接口的,我们需要自定义JS接口
,即在系统接口文件中定义一个JS接口
,才能和小熊派开发板进行交互,接下来我们来看看具体怎么操作。
相关概念
JS自定义接口: 在我们需要使用一些开发环境未提供给我们的能力时,我们可以自定义一些接口。
系统定义接口: 我们定义完JS接口后也是不能直接使用的,必须在系统代码中完成定义的接口才行。
1.创建工程文件
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-HWHq8Wby-1645193642375)(小熊派北向调用南向LED控制接口/image-20220218134307450.png)]
Project type:
ApplicationLanguage:
JSDevice type:
Smart Vision
2.添加接口定义
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-9xskpZv9-1645193642376)(小熊派北向调用南向LED控制接口/image-20220218135253715.png)]
首先想要调用系统未提供的接口时需要现在系统接口文件中定义一个JS接口,这里我们就在 @system.app.d.ts
文件中定义该接口。找到后在其中添加你需要定义的接口,该接口必须是在系统代码中你所实现的接口
(也就是需要参考南向的系统接口开发),必须是南向封装好的驱动接口,才能在该文件进行添加,添加完成后就可以在代码中调用了。具体文件位置如上图所示。
我们这里以LED的例子,在 @system.app.d.ts
文件中的 export default class App {}
类里添加了这样一个接口。
export default class App {
/**
* Obtains the declared information in the config.json file of an application.
*/
static getInfo(): AppResponse;
/**
* Destroys the current ability.
*/
static terminate(): void;
//自定义接口
static ledcontrol(options: {
code: number;
success?: (res: string) => void;
fail?: (res: string, code: number) => void;
complete?: () => void;
}): void;
}
该接口就是控制LED灯的开关。
code:
指令代码0:
关闭LED1:
打开LED2:
led状态翻转
success,fail:
状态回调函数res:
该请求的回复,code:
返回当前led状态,0:关闭状态,1:打开状态。
这样我们JS自定义接口就完成啦。
3.编写页面代码
首先是index.hml代码:
<div class="container">
<div class="title-view">
<div class="back-view" onclick="exit">
<image class=