Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
282c76f8
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看板
未验证
提交
282c76f8
编写于
8月 23, 2023
作者:
O
openharmony_ci
提交者:
Gitee
8月 23, 2023
浏览文件
操作
浏览文件
下载
差异文件
!22734 docs:【NFC】dts 和 md 一致性检查
Merge pull request !22734 from wujie/master
上级
31b41847
ac9b1086
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
191 addition
and
1 deletion
+191
-1
zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md
...n/application-dev/reference/apis/js-apis-cardEmulation.md
+176
-0
zh-cn/application-dev/reference/apis/js-apis-nfcTag.md
zh-cn/application-dev/reference/apis/js-apis-nfcTag.md
+1
-1
zh-cn/application-dev/reference/apis/js-apis-nfctech.md
zh-cn/application-dev/reference/apis/js-apis-nfctech.md
+14
-0
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-cardEmulation.md
浏览文件 @
282c76f8
...
...
@@ -100,6 +100,182 @@ isDefaultService(elementName: ElementName, type: CardType): boolean
| ------- | ------------------------------------ |
| boolean | true: 是默认支付应用,
false: 不是默认支付应用。 |
## HceService<sup>8+</sup>
提供HCE卡模拟的实现,主要包括接收对端读卡设备的APDU数据,并响应APDU数据到对端读卡设备。使用HCE相关接口前,必须先判断设备是否支持HCE卡模拟能力。暂不支持使用,仅做接口声明。
### startHCE<sup>8+</sup>
startHCE(aidList: string[]): boolean
启动HCE业务功能。包括设置当前应用为前台优先,动态注册AID列表。暂不支持使用,仅做接口声明。
> **说明:**
> 从 API version 8 开始支持,从 API version 9 开始废弃,建议使用[start](#start9)替代。
**需要权限:**
ohos.permission.NFC_CARD_EMULATION
**系统能力:**
SystemCapability.Communication.NFC.CardEmulation
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | -------- | ---- | ----------------------- |
| aidList | string[] | 是 | 动态注册卡模拟的AID列表。 |
### start<sup>9+</sup>
start(elementName: ElementName, aidList: string[]): void
启动HCE业务功能。包括设置当前应用为前台优先,动态注册AID列表。暂不支持使用,仅做接口声明。
**需要权限:**
ohos.permission.NFC_CARD_EMULATION
**系统能力:**
SystemCapability.Communication.NFC.CardEmulation
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | -------- | ---- | ----------------------- |
| elementName | ElementName | 是 | 服务能力的元素名称。 |
| aidList | string[] | 是 | 动态注册卡模拟的AID列表。 |
**错误码:**
以下错误码的详细介绍请参见
[
NFC错误码
](
../errorcodes/errorcode-nfc.md
)
。
| 错误码ID | 错误信息|
| ------- | -------|
| 3100301 | Card emulation running state is abnormal in service. |
### stopHCE<sup>8+</sup>
stopHCE(): boolean
停止HCE业务功能。包括退出当前应用前台优先,释放动态注册的AID列表。暂不支持使用,仅做接口声明。
> **说明:**
> 从 API version 8 开始支持,从 API version 9 开始废弃,建议使用[stop](#stop)替代。
**需要权限:**
ohos.permission.NFC_CARD_EMULATION
**系统能力:**
SystemCapability.Communication.NFC.CardEmulation
### stop<sup>9+</sup>
stop(elementName: ElementName): void;
停止HCE业务功能。包括退出当前应用前台优先,释放动态注册的AID列表。暂不支持使用,仅做接口声明。
**需要权限:**
ohos.permission.NFC_CARD_EMULATION
**系统能力:**
SystemCapability.Communication.NFC.CardEmulation
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | -------- | ---- | ----------------------- |
| elementName | ElementName | 是 | 服务能力的元素名称。 |
**错误码:**
以下错误码的详细介绍请参见
[
NFC错误码
](
../errorcodes/errorcode-nfc.md
)
。
| 错误码ID | 错误信息|
| ------- | -------|
| 3100301 | Card emulation running state is abnormal in service. |
### on<sup>8+</sup>
on(type: "hceCmd", callback: AsyncCallback
<number
[]
>
): void;
订阅回调,用于接收对端读卡设备发送的APDU数据。暂不支持使用,仅做接口声明。
**需要权限:**
ohos.permission.NFC_CARD_EMULATION
**系统能力:**
SystemCapability.Communication.NFC.CardEmulation
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------- | ---- | -------------------------------------------- |
| type | string | 是 | 固定填"hceCmd"字符串。 |
| callback | AsyncCallback
<number
[]
>
| 是 | 订阅的事件回调,入参是符合APDU协议的数据,每个number十六进制表示,范围是0x00~0xFF。 |
### sendResponse<sup>8+</sup>
sendResponse(responseApdu: number[]): void;
发送APDU数据到对端读卡设备。暂不支持使用,仅做接口声明。
> **说明:**
> 从 API version 8 开始支持,从 API version 9 开始废弃,建议使用[transmit](#transmit9)替代。
**需要权限:**
ohos.permission.NFC_CARD_EMULATION
**系统能力:**
SystemCapability.Communication.NFC.CardEmulation
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | -------- | ---- | -------------------------------------------------- |
| responseApdu | number[] | 是 | 发送到对端读卡设备的符合APDU协议的数据,每个number十六进制表示,范围是0x00~0xFF。 |
### transmit<sup>9+</sup>
transmit(response: number[]): Promise
<void>
;
发送APDU数据到对端读卡设备。暂不支持使用,仅做接口声明。
**需要权限:**
ohos.permission.NFC_CARD_EMULATION
**系统能力:**
SystemCapability.Communication.NFC.CardEmulation
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------------ | -------- | ---- | -------------------------------------------------- |
| responseApdu | number[] | 是 | 发送到对端读卡设备的符合APDU协议的数据,每个number十六进制表示,范围是0x00~0xFF。 |
**返回值:**
|
**类型**
|
**说明**
|
| ------- | -------------------------------------- |
| Promise
<void>
| 表示异步回调完成。 |
**错误码:**
以下错误码的详细介绍请参见
[
NFC错误码
](
../errorcodes/errorcode-nfc.md
)
。
| 错误码ID | 错误信息|
| ------- | -------|
| 3100301 | Card emulation running state is abnormal in service. |
### transmit<sup>9+</sup>
transmit(response: number[], callback: AsyncCallback
<void>
): void;
发送APDU数据到对端读卡设备。暂不支持使用,仅做接口声明。
**需要权限:**
ohos.permission.NFC_CARD_EMULATION
**系统能力:**
SystemCapability.Communication.NFC.CardEmulation
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | -------- | ---- | ----------------------- |
| responseApdu | number[] | 是 | 发送到对端读卡设备的符合APDU协议的数据,每个number十六进制表示,范围是0x00~0xFF。 |
| callback | AsyncCallback
<void>
| 是 | 回调函数void |
**错误码:**
以下错误码的详细介绍请参见
[
NFC错误码
](
../errorcodes/errorcode-nfc.md
)
。
| 错误码ID | 错误信息|
| ------- | -------|
| 3100301 | Card emulation running state is abnormal in service. |
**示例:**
```
js
...
...
zh-cn/application-dev/reference/apis/js-apis-nfcTag.md
浏览文件 @
282c76f8
...
...
@@ -525,7 +525,7 @@ import tag from '@ohos.nfc.tag';
let
elementName
=
null
;
let
discTech
=
[
tag
.
NFC_A
,
tag
.
NFC_B
];
// replace with the tech(s) that is needed by foreground ability
function
foregroundCb
(
err
,
tag
i
nfo
)
{
function
foregroundCb
(
err
,
tag
I
nfo
)
{
if
(
!
err
)
{
console
.
log
(
"
foreground callback: tag found tagInfo =
"
,
JSON
.
stringify
(
tagInfo
));
}
else
{
...
...
zh-cn/application-dev/reference/apis/js-apis-nfctech.md
浏览文件 @
282c76f8
...
...
@@ -2188,6 +2188,13 @@ format(message: [NdefMessage](#ndefmessage9), callback: AsyncCallback\<void>): v
| ------------------ | --------------------------|
| callback: AsyncCallback
\<
void> | 回调函数。 |
**错误码:**
以下错误码的详细介绍请参见
[
NFC错误码
](
../errorcodes/errorcode-nfc.md
)
。
| 错误码ID | 错误信息|
| ------- | -------|
| 3100201 | Tag running state is abnormal in service. |
**示例:**
...
...
@@ -2297,6 +2304,13 @@ formatReadOnly(message: [NdefMessage](#ndefmessage9), callback: AsyncCallback\<v
| ------------------ | --------------------------|
| callback: AsyncCallback
\<
void> | 回调函数。 |
**错误码:**
以下错误码的详细介绍请参见
[
NFC错误码
](
../errorcodes/errorcode-nfc.md
)
。
| 错误码ID | 错误信息|
| ------- | -------|
| 3100201 | Tag running state is abnormal in service. |
**示例:**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录