Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
840fefd1
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看板
提交
840fefd1
编写于
3月 14, 2022
作者:
Z
zhaoyi
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add js apis connectedTag
Signed-off-by:
N
zhaoyi
<
zhaoyi46@huawei.com
>
上级
447fd830
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
223 addition
and
0 deletion
+223
-0
zh-cn/application-dev/reference/apis/js-apis-connectedTag.md
zh-cn/application-dev/reference/apis/js-apis-connectedTag.md
+223
-0
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-connectedTag.md
0 → 100644
浏览文件 @
840fefd1
# 有源标签
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import connectedTag from '@ohos.connectedTag';
```
## connectedTag.init
init(): boolean
初始化有源标签芯片。
**需要权限**
:ohos.permission.NFC_TAG
**系统能力**
:SystemCapability.Communication.ConnectedTag
-
返回值:
|
**类型**
|
**说明**
|
| -------- | -------- |
| boolean | true:初始化成功,
false:初始化失败。 |
## connectedTag.uninit
uninit(): boolean
卸载有源标签芯片资源。
**需要权限**
:ohos.permission.NFC_TAG
**系统能力**
:SystemCapability.Communication.ConnectedTag
-
返回值:
|
**类型**
|
**说明**
|
| -------- | -------- |
| boolean | true:卸载操作成功,
false:卸载操作失败。 |
## connectedTag.readNdefTag
readNdefTag(): Promise
<
string
>
读取有源标签内容,使用promise方式作为异步方法。
**需要权限**
:ohos.permission.NFC_TAG
**系统能力**
:SystemCapability.Communication.ConnectedTag
-
返回值:
|
**类型**
|
**说明**
|
| -------- | -------- |
| Promise
<
string
>
| 返回读取有源标签内容。 |
-
示例
```
import connectedTag from '@ohos.connectedTag';
connectedTag.readNdefTag().then(result => {
console.log("promise recv ndef response: " + result);
});
```
## connectedTag.readNdefTag
readNdefTag(callback: AsyncCallback
<
string
>
): void
读取有源标签内容,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.NFC_TAG
**系统能力**
:SystemCapability.Communication.ConnectedTag
-
参数
|
**参数名**
|
**类型**
|
**必填**
|
**说明**
|
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback
<
string
>
| 是 | 读取有源标签内容回调函数。 |
-
示例
```
import connectedTag from '@ohos.connectedTag';
connectedTag.readNdefTag(result => {
console.log("callback recv ndef response: " + result);
});
```
## connectedTag.writeNdefTag
writeNdefTag(data: string): Promise
<
void
>
写入内容到有源标签,使用promise方式作为异步方法。
**需要权限**
:ohos.permission.NFC_TAG
**系统能力**
:SystemCapability.Communication.ConnectedTag
-
参数
|
**参数名**
|
**类型**
|
**必填**
|
**说明**
|
| -------- | -------- | -------- | -------- |
| data | string | 是 | 有源标签内容, 长度最大是1024个字节。 |
-
返回值:
|
**类型**
|
**说明**
|
| -------- | -------- |
| Promise
<
void
>
| 无返回值。 |
-
示例
```
import connectedTag from '@ohos.connectedTag';
writeNdefTag.write("010203")
.then((value) => {
// 事件写入正常
console.log(`success to write event: ${value}`);
}).catch((err) => {
// 事件写入异常
console.error(`failed to write event because ${err.code}`);
});
```
## connectedTag.writeNdefTag
writeNdefTag(data: string, callback: AsyncCallback
<
string
>
): void
写入内容到有源标签,使用callback方式作为异步方法。
**需要权限**
:ohos.permission.NFC_TAG
**系统能力**
:SystemCapability.Communication.ConnectedTag
-
参数
|
**参数名**
|
**类型**
|
**必填**
|
**说明**
|
| -------- | -------- | -------- | -------- |
| data | string | 是 | 有源标签内容, 长度最大是1024个字节。 |
| callback | AsyncCallback
<
string
>
| 是 | 读取有源标签内容回调函数。 |
-
示例
```
import connectedTag from '@ohos.connectedTag';
connectedTag.writeNdefTag("010203", (err, value) => {
if (err) {
// 事件写入异常
console.error(`failed to write event because ${err.code}`);
return;
}
// 事件写入正常
console.log(`success to write event: ${value}`);
});
```
## connectedTag.on('notify')
on(type: "notify", callback: Callback
<
number
>
): void
注册NFC场强状态事件。
**需要权限**
:ohos.permission.NFC_TAG
**系统能力**
:SystemCapability.Communication.ConnectedTag
-
参数
|
**参数名**
|
**类型**
|
**必填**
|
**说明**
|
| -------- | -------- | -------- | -------- |
| type | string | 是 | 固定填"notify"字符串 |
| callback | Callback
<
number
>
| 是 | 状态改变回调函数。 |
-
状态改变事件的枚举。
|
**枚举值**
|
**说明**
|
| -------- | -------- |
| 0 | NFC离场事件 |
| 1 | NFC进场事件 |
## connectedTag.off('notify')
off(type: "notify", callback?: Callback
<
number
>
): void
取消NFC场强状态事件的注册。
**需要权限**
:ohos.permission.NFC_TAG
**系统能力**
:SystemCapability.Communication.ConnectedTag
-
参数
|
**参数名**
|
**类型**
|
**必填**
|
**说明**
|
| -------- | -------- | -------- | -------- |
| type | string | 是 | 固定填"notify"字符串 |
| callback | Callback
<
number
>
| 否 | 状态改变回调函数。如果callback不填,将“去注册”该事件关联的所有回调函数。 |
-
示例
```
import connectedTag from '@ohos.connectedTag';
var NFC_RF_NOTIFY = "notify";
var recvNfcRfNotifyFunc = result => {
console.info("nfc rf receive state: " + result);
}
// Register event
connectedTag.on(NFC_RF_NOTIFY, recvNfcRfNotifyFunc);
// Unregister event
connectedTag.off(NFC_RF_NOTIFY, recvNfcRfNotifyFunc);
```
## NfcRfType
表示NFC场强状态的枚举。
| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
| NFC_RF_LEAVE | 0 | NFC离场事件 |
| NFC_RF_ENTER | 1 | NFC进场事件 |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录