!17562 fix：【nfc】Docs code repository api9 replaces api8

Merge pull request !17562 from wujie/master

zh-cn/application-dev/reference/apis/js-apis-connectedTag.md

@@ -28,6 +28,23 @@ init(): boolean
 | -------- | -------- |
 | boolean | true:初始化成功， false:初始化失败。 |
 
+## connectedTag.initialize<sup>9+</sup>
+
+initialize(): void
+
+初始化有源标签芯片。
+
+**需要权限：** ohos.permission.NFC_TAG
+
+**系统能力：** SystemCapability.Communication.ConnectedTag
+
+**错误码：**
+以下错误码的详细介绍请参见[NFC错误码](../errorcodes/errorcode-nfc.md)。
+
+| 错误码ID | 错误信息|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
 ## connectedTag.uninit
 
 uninit(): boolean
@@ -44,6 +61,23 @@ uninit(): boolean
 | -------- | -------- |
 | boolean | true:卸载操作成功，&nbsp;false:卸载操作失败。 |
 
+## connectedTag.uninitialize<sup>9+</sup>
+
+uninitialize(): void
+
+卸载有源标签芯片资源。
+
+**需要权限:** ohos.permission.NFC_TAG
+
+**系统能力:** SystemCapability.Communication.ConnectedTag
+
+**错误码：**
+以下错误码的详细介绍请参见[NFC错误码](../errorcodes/errorcode-nfc.md)。
+
+| 错误码ID | 错误信息|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
 ## connectedTag.readNdefTag
 
 readNdefTag(): Promise&lt;string&gt;
@@ -72,6 +106,41 @@ connectedTag.readNdefTag().then((data) => {
 });
 ```
 
+## connectedTag.read<sup>9+</sup>
+
+read(): Promise&lt;number[]&gt;
+
+读取有源标签内容，使用promise方式作为异步方法。
+
+**需要权限：** ohos.permission.NFC_TAG
+
+**系统能力：** SystemCapability.Communication.ConnectedTag
+
+**返回值：**
+
+| **类型** | **说明** |
+| -------- | -------- |
+| Promise&lt;number[]&gt; | 返回读取有源标签内容。 |
+
+**错误码：**
+以下错误码的详细介绍请参见[NFC错误码](../errorcodes/errorcode-nfc.md)。
+
+| 错误码ID | 错误信息|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
+**示例：**
+
+```js
+import connectedTag from '@ohos.connectedTag';
+
+connectedTag.read().then((data) => {
+    console.log("connectedTag read Promise data = " + data);
+}).catch((err)=> {
+    console.log("connectedTag read Promise err: " + err);
+});
+```
+
 ## connectedTag.readNdefTag
 
 readNdefTag(callback: AsyncCallback&lt;string&gt;): void
@@ -102,6 +171,43 @@ connectedTag.readNdefTag((err, data)=> {
 });
 ```
 
+## connectedTag.read<sup>9+</sup>
+
+read(callback: AsyncCallback&lt;number[]&gt;): void
+
+读取有源标签内容，使用AsyncCallback方式作为异步方法。
+
+**需要权限：** ohos.permission.NFC_TAG
+
+**系统能力：** SystemCapability.Communication.ConnectedTag
+
+**参数：**
+
+| **参数名** | **类型** | **必填** | **说明** |
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback&lt;number[]&gt; | 是 | 读取有源标签内容回调函数。 |
+
+**错误码：**
+以下错误码的详细介绍请参见[NFC错误码](../errorcodes/errorcode-nfc.md)。
+
+| 错误码ID | 错误信息|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
+**示例：**
+
+```js
+import connectedTag from '@ohos.connectedTag';
+
+connectedTag.read((err, data)=> {
+    if (err) {
+        console.log("connectedTag read AsyncCallback err: " + err);
+    } else {
+        console.log("connectedTag read AsyncCallback data: " + data);
+    }
+});
+```
+
 ## connectedTag.writeNdefTag
 
 writeNdefTag(data: string): Promise&lt;void&gt;
@@ -137,6 +243,48 @@ connectedTag.writeNdefTag(rawData).then(() => {
 });
 ```
 
+## connectedTag.write<sup>9+</sup>
+
+write(data: number[]): Promise&lt;void&gt;
+
+写入内容到有源标签，使用promise方式作为异步方法。
+
+**需要权限：** ohos.permission.NFC_TAG
+
+**系统能力：** SystemCapability.Communication.ConnectedTag
+
+**参数：**
+
+| **参数名** | **类型** | **必填** | **说明** |
+| -------- | -------- | -------- | -------- |
+| data | number[] | 是 | 有源标签内容, 由十六进制数字组成，范围从0x00至0xFF。 |
+
+**返回值：**
+
+| **类型** | **说明** |
+| -------- | -------- |
+| Promise&lt;void&gt; | 无返回值。 |
+
+**错误码：**
+以下错误码的详细介绍请参见[NFC错误码](../errorcodes/errorcode-nfc.md)。
+
+| 错误码ID | 错误信息|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
+**示例：**
+
+```js
+import connectedTag from '@ohos.connectedTag';
+
+var rawData = [0x01, 0x02, 0x03]; // change it tobe correct.
+connectedTag.write(rawData).then(() => {
+    console.log("connectedTag write NdefTag Promise success.");
+}).catch((err)=> {
+    console.log("connectedTag write NdefTag Promise err: " + err);
+});
+```
+
 ## connectedTag.writeNdefTag
 
 writeNdefTag(data: string, callback: AsyncCallback&lt;void&gt;): void
@@ -169,6 +317,45 @@ connectedTag.writeNdefTag(rawData, (err)=> {
 });
 ```
 
+## connectedTag.write<sup>9+</sup>
+
+write(data: number[], callback: AsyncCallback&lt;void&gt;): void
+
+写入内容到有源标签，使用AsyncCallback方式作为异步方法。
+
+**需要权限：** ohos.permission.NFC_TAG
+
+**系统能力：** SystemCapability.Communication.ConnectedTag
+
+**参数：**
+
+| **参数名** | **类型** | **必填** | **说明** |
+| -------- | -------- | -------- | -------- |
+| data | number[] | 是 | 有源标签内容, 由十六进制数字组成，范围从0x00至0xFF。 |
+| callback | AsyncCallback&lt;void&gt; | 是 | 读取有源标签内容回调函数。 |
+
+**错误码：**
+以下错误码的详细介绍请参见[NFC错误码](../errorcodes/errorcode-nfc.md)。
+
+| 错误码ID | 错误信息|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
+**示例：**
+
+```js
+import connectedTag from '@ohos.connectedTag';
+
+var rawData = [0x01, 0x02, 0x03]; // change it tobe correct.
+connectedTag.write(rawData, (err)=> {
+    if (err) {
+        console.log("connectedTag write NdefTag AsyncCallback err: " + err);
+    } else {
+        console.log("connectedTag write NdefTag AsyncCallback success.");
+    }
+});
+```
+
 ## connectedTag.on('notify')
 
 on(type: "notify", callback: Callback&lt;number&gt;): void

zh-cn/application-dev/reference/errorcodes/errorcode-nfc.md

@@ -48,3 +48,20 @@ NFC服务执行Tag业务逻辑遇到错误。
 4. 重新触碰读取卡片。
 5. 退出应用后，重新读取卡片。
 
+## 3200101
+
+**错误信息**
+
+Connected NFC tag running state is abnormal in service.
+
+**错误描述**
+
+执行有源NFC Tag业务逻辑遇到错误。
+
+**可能原因**
+1. 有源NFC Tag参数值和实际调用函数要求不匹配。
+2. 有源NFC Tag芯片返回错误状态或响应超时。
+
+**处理步骤**
+1. 检查有源NFC Tag参数是否和所调用接口匹配。
+2. 重新触碰读取卡片。