!23909 [翻译完成】#I7VFZ0

Merge pull request !23909 from Annie_wang/PR22734

en/application-dev/reference/apis/js-apis-cardEmulation.md

@@ -100,6 +100,182 @@ Checks whether an application is the default application of the specified servic
 | ------- | ------------------------------------ |
 | boolean | Returns **true** if the application is the default payment application; returns **false** otherwise.|
 
+## HceService<sup>8+</sup>
+
+Implements HCE, including receiving Application Protocol Data Units (APDUs) from the peer card reader and sending a response. Before using HCE-related APIs, check whether the device supports HCE. This API is used only for declaration and cannot be used currently.
+
+### startHCE<sup>8+</sup>
+
+startHCE(aidList: string[]): boolean
+
+Starts HCE, including setting the application to be foreground preferred and dynamically registering the application identifier (AID) list. This API is used only for declaration and cannot be used currently.
+
+> **NOTE**
+> This API is supported since API version 8 and deprecated since API version 9. You are advised to use [start](#start9).
+
+**Required permissions**: ohos.permission.NFC_CARD_EMULATION
+
+**System capability**: SystemCapability.Communication.NFC.CardEmulation
+
+**Parameters**
+
+| Name | Type    | Mandatory| Description                   |
+| ------- | -------- | ---- | ----------------------- |
+| aidList | string[] | Yes  | AID list to register.|
+
+### start<sup>9+</sup>
+
+start(elementName: ElementName, aidList: string[]): void
+
+Starts HCE, including setting the application to be foreground preferred and dynamically registering the application identifier (AID) list. This API is used only for declaration and cannot be used currently.
+
+**Required permissions**: ohos.permission.NFC_CARD_EMULATION
+
+**System capability**: SystemCapability.Communication.NFC.CardEmulation
+
+**Parameters**
+
+| Name | Type    | Mandatory| Description                   |
+| ------- | -------- | ---- | ----------------------- |
+| elementName | ElementName | Yes  | Element name of a service capability.|
+| aidList | string[] | Yes  | AID list to register.|
+
+**Error codes**
+
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message |
+| ------- | -------|
+| 3100301 | Card emulation running state is abnormal in service. |
+
+### stopHCE<sup>8+</sup>
+
+stopHCE(): boolean
+
+Stops HCE, including removing the foreground preferred attribute and releasing the dynamically registered AID list. This API is used only for declaration and cannot be used currently.
+
+> **NOTE**
+> This API is supported since API version 8 and deprecated since API version 9. You are advised to use [stop](#stop).
+
+**Required permissions**: ohos.permission.NFC_CARD_EMULATION
+
+**System capability**: SystemCapability.Communication.NFC.CardEmulation
+
+### stop<sup>9+</sup>
+
+stop(elementName: ElementName): void;
+
+Stops HCE, including removing the foreground preferred attribute and releasing the dynamically registered AID list. This API is used only for declaration and cannot be used currently.
+
+**Required permissions**: ohos.permission.NFC_CARD_EMULATION
+
+**System capability**: SystemCapability.Communication.NFC.CardEmulation
+
+**Parameters**
+
+| Name | Type    | Mandatory| Description                   |
+| ------- | -------- | ---- | ----------------------- |
+| elementName | ElementName | Yes  | Element name of a service capability.|
+
+**Error codes**
+
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message |
+| ------- | -------|
+| 3100301 | Card emulation running state is abnormal in service. |
+
+### on<sup>8+</sup>
+
+on(type: "hceCmd", callback: AsyncCallback<number[]>): void;
+
+Registers a callback to receive APDUs from the peer card reader. This API is used only for declaration and cannot be used currently.
+
+**Required permissions**: ohos.permission.NFC_CARD_EMULATION
+
+**System capability**: SystemCapability.Communication.NFC.CardEmulation
+
+**Parameters**
+
+| Name  | Type                   | Mandatory| Description                                        |
+| -------- | ----------------------- | ---- | -------------------------------------------- |
+| type     | string                  | Yes  | Event type to subscribe to. The value is **hceCmd**.                        |
+| callback | AsyncCallback<number[]> | Yes  | Callback invoked to return the APDU, which consists of hexadecimal numbers ranging from **0x00** to **0xFF**.|
+
+### sendResponse<sup>8+</sup>
+
+sendResponse(responseApdu: number[]): void;
+
+Sends a response to the peer card reader. This API is used only for declaration and cannot be used currently.
+
+> **NOTE**
+> This API is supported since API version 8 and deprecated since API version 9. You are advised to use [transmit](#transmit9).
+
+**Required permissions**: ohos.permission.NFC_CARD_EMULATION
+
+**System capability**: SystemCapability.Communication.NFC.CardEmulation
+
+**Parameters**
+
+| Name      | Type    | Mandatory| Description                                              |
+| ------------ | -------- | ---- | -------------------------------------------------- |
+| responseApdu | number[] | Yes  | Response APDU sent to the peer card reader. The value consists of hexadecimal numbers ranging from **0x00** to **0xFF**.|
+
+### transmit<sup>9+</sup>
+
+transmit(response: number[]): Promise\<void>;
+
+Sends a response to the peer card reader. This API is used only for declaration and cannot be used currently.
+
+**Required permissions**: ohos.permission.NFC_CARD_EMULATION
+
+**System capability**: SystemCapability.Communication.NFC.CardEmulation
+
+**Parameters**
+
+| Name      | Type    | Mandatory| Description                                              |
+| ------------ | -------- | ---- | -------------------------------------------------- |
+| responseApdu | number[] | Yes  | Response APDU sent to the peer card reader. The value consists of hexadecimal numbers ranging from **0x00** to **0xFF**.|
+
+**Return value**
+
+| **Type** | **Description**                                |
+| ------- | -------------------------------------- |
+| Promise\<void> | Promise that returns no value.|
+
+**Error codes**
+
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message |
+| ------- | -------|
+| 3100301 | Card emulation running state is abnormal in service. |
+
+### transmit<sup>9+</sup>
+
+transmit(response: number[], callback: AsyncCallback\<void>): void;
+
+Sends a response to the peer card reader. This API is used only for declaration and cannot be used currently.
+
+**Required permissions**: ohos.permission.NFC_CARD_EMULATION
+
+**System capability**: SystemCapability.Communication.NFC.CardEmulation
+
+**Parameters**
+
+| Name | Type    | Mandatory| Description                   |
+| ------- | -------- | ---- | ----------------------- |
+| responseApdu | number[] | Yes  | Response APDU sent to the peer card reader. The value consists of hexadecimal numbers ranging from **0x00** to **0xFF**.|
+| callback | AsyncCallback\<void> | Yes  | Callback that returns no value.|
+
+**Error codes**
+
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message |
+| ------- | -------|
+| 3100301 | Card emulation running state is abnormal in service. |
+
 **Example**
 
 ```js

en/application-dev/reference/apis/js-apis-nfcTag.md

@@ -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, taginfo) {
+function foregroundCb(err, tagInfo) {
     if (!err) {
         console.log("foreground callback: tag found tagInfo = ", JSON.stringify(tagInfo));
     } else {

en/application-dev/reference/apis/js-apis-nfctech.md

@@ -1863,7 +1863,7 @@ The following describes the unique APIs of **MifareUltralightTag**.
 
 readMultiplePages(pageIndex: number): Promise\<number[]>
 
-Reads four pages (4 bytes per page) from this tag. This API uses a promise to return the result.
+Reads four pages of data (4 bytes per page) from this tag. This API uses a promise to return the result.
 
 **Required permissions**: ohos.permission.NFC_TAG
 
@@ -1921,7 +1921,7 @@ try {
 
 readMultiplePages(pageIndex: number, callback: AsyncCallback\<number[]>): void
 
-Reads four pages (4 bytes per page) from this tag. This API uses an asynchronous callback to return the result.
+Reads four pages of data (4 bytes per page) from this tag. This API uses an asynchronous callback to return the result.
 
 **Required permissions**: ohos.permission.NFC_TAG
 
@@ -2188,6 +2188,13 @@ Formats this tag as an NDEF tag, and writes an NDEF message to it. This API uses
 | ------------------ | --------------------------|
 | callback: AsyncCallback\<void> | Callback invoked to return the result.|
 
+**Error codes**
+
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message|
+| ------- | -------|
+| 3100201 | Tag running state is abnormal in service. |
 
 **Example**
 
@@ -2297,6 +2304,13 @@ Formats this tag as an NDEF tag, writes an NDEF message to the NDEF tag, and the
 | ------------------ | --------------------------|
 | callback: AsyncCallback\<void> | Callback invoked to return the result.|
 
+**Error codes**
+
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message|
+| ------- | -------|
+| 3100201 | Tag running state is abnormal in service. |
 
 **Example**