!13618 [翻译完成】#I63LMS

Merge pull request !13618 from Annie_wang/PR11919A

en/application-dev/reference/apis/js-apis-useriam-faceauth.md

-#  @ohos.userIAM.faceAuth (Facial Authentication)
+# @ohos.userIAM.faceAuth (Facial Authentication)
 
 The **userIAM.faceAuth** module provides APIs for face enrollment.
 
@@ -34,17 +34,17 @@ A constructor used to create a **FaceAuthManager** object.
 
 **Example**
 
-  ```js
-  import userIAM_faceAuth from '@ohos.userIAM.faceAuth';
+```js
+import userIAM_faceAuth from '@ohos.userIAM.faceAuth';
 
-  let faceAuthManager = new userIAM_faceAuth.FaceAuthManager();
-  ```
+let faceAuthManager = new userIAM_faceAuth.FaceAuthManager();
+```
 
 ### setSurfaceId
 
 setSurfaceId(surfaceId: string): void;
 
-Sets an [XComponent surface ID](../arkui-ts/ts-basic-components-xcomponent.md#getxcomponentsurfaceid) for the face preview page in the face enrollment process.
+Sets an [XComponent surface ID](../arkui-ts/ts-basic-components-xcomponent.md#getxcomponentsurfaceid) for the face preview page in the face enrollment process. This API must be used with [AddCredential](./js-apis-osAccount.md#addcredential8).
 
 **System capability**: SystemCapability.UserIAM.UserAuth.FaceAuth
 
@@ -56,17 +56,28 @@ Sets an [XComponent surface ID](../arkui-ts/ts-basic-components-xcomponent.md#ge
 | -------------- | ---------------------------------- | ---- | -------------------------- |
 | surfaceId       | string     | Yes  | ID of the surface held by the [XComponent](../arkui-ts/ts-basic-components-xcomponent.md#getxcomponentsurfaceid).|
 
+For details about the following error codes, see [User Authentication Error Codes](../errorcodes/errorcode-useriam.md).
+
+**Error codes**
+
+| ID| Error Message|
+| -------- | ------- |
+| 201 | Permission verification failed. |
+| 202 | The caller is not a system application. |
+| 12700001 | The operation is failed. |
+
 **Example**
 
-  ```js
-  import faceAuth from '@ohos.userIAM.faceAuth';
-
-  let surfaceId = "123456";
-  let manager = new faceAuth.FaceAuthManager();
-  try {
-      manager.setSurfaceId(surfaceId);
-      console.info("Set the surface ID successfully");
-  } catch (e) {
-      console.error("Failed to set the surface ID, error = " + e);
-  }
-  ```
+```js
+import userIAM_faceAuth from '@ohos.userIAM.faceAuth';
+
+// The surfaceId is obtained from the XComponent control. The surfaceId here is only an example.
+let surfaceId = "123456";
+let manager = new userIAM_faceAuth.FaceAuthManager();
+try {
+    manager.setSurfaceId(surfaceId);
+    console.info("Set the surface ID successfully");
+} catch (e) {
+    console.error("Failed to set the surface ID, error = " + e);
+}
+```

en/application-dev/reference/errorcodes/Readme-EN.md

@@ -33,8 +33,11 @@
 - Security
   - [Ability Access Control Error Codes](errorcode-access-token.md)
   - [HUKS Error Codes](errorcode-huks.md)
+  - [User Authentication Error Codes](errorcode-useriam.md)
 - Data Management
   - [RDB Error Codes](errorcode-data-rdb.md)
+  - [DataShare Error Codes](errorcode-datashare.md)
+  - [Distributed Data Object Error Codes](errorcode-distributed-dataObject.md)
   - [Distributed KV Store Error Codes](errorcode-distributedKVStore.md)
   - [Preferences Error Codes](errorcode-preferences.md)
 - File Management

en/application-dev/reference/errorcodes/errorcode-distributed-dataObject.md

+# Distributed Data Object Error Codes
+
+## 15400001 Failed to Create the In-Memory Database
+
+**Error Message**
+
+Create table failed.
+
+**Description**
+
+The in-memory database fails to be created.
+
+**Possible Causes**
+
+An object with the same session ID already exists.
+
+**Solution**
+
+Check for the object has been added to the same session.

en/application-dev/reference/errorcodes/errorcode-useriam.md

+#  User Authentication Error Codes
+
+## 201 Permission Verification Failed
+
+For details, see [Universal Error Codes](./errorcode-universal.md).
+
+## 202 Invoker Is Not a System Application
+
+For details, see [Universal Error Codes](./errorcode-universal.md).
+
+## 401 Parameter Check Failed.
+
+For details, see [Universal Error Codes](./errorcode-universal.md).
+
+## 12500001 Authentication Failed
+
+**Error Message**
+
+Authentication failed.
+
+**Possible Causes**
+
+The credential does not match the credential enrolled.
+
+**Solution**
+
+Initiate authentication again.
+
+## 12500002 General Operation Error
+
+**Error Message**
+
+General operation error.
+
+**Possible Causes**
+
+1. An error occurs when the NAPI layer parses parameters.
+2. The process of the user authentication service is not started.
+3. The proxy client fails to write data over IPC.
+4. The stub server fails to parse data over IPC.
+5. The driver service is not obtained.
+
+**Solution**
+
+Call the API again later or restart the device.
+
+## 12500003 Authentication Canceled
+
+**Error Message**
+
+Authentication canceled.
+
+**Possible Causes**
+
+The authentication operation has been canceled.
+
+**Solution**
+
+Initiate the authentication again.
+
+## 12500004 Authentication Timed Out
+
+**Error Message**
+
+Authentication timeout.
+
+**Possible Causes**
+
+The authentication is not complete within the specified time.
+
+**Solution**
+
+Initiate the authentication again.
+
+## 12500005 Unsupported Authentication Type
+
+**Error Message**
+
+The authentication type is not supported.
+
+**Possible Causes**
+
+1. The input authentication type parameter is not supported. For example, if the authentication type passed in **getAvailableStatus** of the **userAuth** module is not **FACE** or **FINGERPRINT**, error code 12500005 is returned.
+2. The device does not support the authentication type. For example, if fingerprint authentication is initiated on a device that has no fingerprint sensor, error code 12500005 is returned.
+
+**Solution**
+
+Check the authentication type parameter and call the API again.
+
+## 12500006 Unsupported Authentication Trust Level
+
+**Error Message**
+
+The authentication trust level is not supported.
+
+**Possible Causes**
+
+1. The **authTrustLevel** value in **getAvailableStatus** or **getAuthInstance** of the **userAuth** module is not in the range [ATL1, ATL2, ATL3, ATL4].
+2. The device does not support the authentication trust level. For example, if facial authentication for payment is initiated on a device that has only 2D cameras, error code 12500006 is returned.
+
+**Solution**
+
+Check that the **authTrustLevel** passed in is within the value range, and the device supports the specified authentication trust level.
+
+## 12500007 Authentication Service Unavailable
+
+**Error Message**
+
+Authentication service is busy.
+
+**Possible Causes**
+
+Another authentication is initiated when the current authentication has not been finished yet.
+
+**Solution**
+
+Initiate authentication again later.
+
+## 12500009 Authentication Locked
+
+**Error Message**
+
+Authentication is lockout.
+
+**Possible Causes**
+
+The number of authentication failures exceeds the limit.
+
+**Solution**
+
+Initiate authentication later.
+
+## 12500010 Credential Not Enrolled
+
+**Error Message**
+
+The type of credential has not been enrolled.
+
+**Possible Causes**
+
+The **authType** parameter set in **getAvailableStatus** of the **userAuth** module is **FACE**, but no facial credential is enrolled in the device.
+**start()** is called to initiate facial authentication, but no facial credential is enrolled in the device.
+
+**Solution**
+
+Check that the related type of credential has been enrolled in the device.
+
+## 12700001 Failed to Enroll Faces
+
+**Error Message**
+
+The operation is failed.
+
+**Possible Causes**
+
+1. The facial authentication service is not started when **setSurfaceId()** of the **userAuth** module is called.
+2. The proxy client fails to write data over IPC.
+3. The stub server fails to parse data over IPC.
+4. An error occurs when the facial authentication driver is invoked.
+
+**Solution**
+
+Call the API again later or restart the device.