提交 e642cbff 编写于 作者: A Annie_wang

Update docs

Signed-off-by: NAnnie_wang <annie.wangli@huawei.com>
上级 36993f06
...@@ -1100,8 +1100,6 @@ getAllAccounts(callback: AsyncCallback&lt;Array&lt;AppAccountInfo&gt;&gt;): void ...@@ -1100,8 +1100,6 @@ getAllAccounts(callback: AsyncCallback&lt;Array&lt;AppAccountInfo&gt;&gt;): void
Obtains information about all accessible app accounts. This API uses an asynchronous callback to return the result. Obtains information about all accessible app accounts. This API uses an asynchronous callback to return the result.
**Required permissions**: ohos.permission.GET_ALL_APP_ACCOUNTS
**System capability**: SystemCapability.Account.AppAccount **System capability**: SystemCapability.Account.AppAccount
**Parameters** **Parameters**
...@@ -1138,8 +1136,6 @@ getAllAccounts(): Promise&lt;Array&lt;AppAccountInfo&gt;&gt; ...@@ -1138,8 +1136,6 @@ getAllAccounts(): Promise&lt;Array&lt;AppAccountInfo&gt;&gt;
Obtains information about all accessible app accounts. This API uses a promise to return the result. Obtains information about all accessible app accounts. This API uses a promise to return the result.
**Required permissions**: ohos.permission.GET_ALL_APP_ACCOUNTS
**System capability**: SystemCapability.Account.AppAccount **System capability**: SystemCapability.Account.AppAccount
**Return value** **Return value**
...@@ -1174,8 +1170,6 @@ getAccountsByOwner(owner: string, callback: AsyncCallback&lt;Array&lt;AppAccount ...@@ -1174,8 +1170,6 @@ getAccountsByOwner(owner: string, callback: AsyncCallback&lt;Array&lt;AppAccount
Obtains the app accounts that can be accessed by the invoker based on the app account owner. This API uses an asynchronous callback to return the result. Obtains the app accounts that can be accessed by the invoker based on the app account owner. This API uses an asynchronous callback to return the result.
**Required permissions**: ohos.permission.GET_ALL_APP_ACCOUNTS
**System capability**: SystemCapability.Account.AppAccount **System capability**: SystemCapability.Account.AppAccount
**Parameters** **Parameters**
...@@ -1214,7 +1208,6 @@ Obtains the app accounts that can be accessed by the invoker based on the app ac ...@@ -1214,7 +1208,6 @@ Obtains the app accounts that can be accessed by the invoker based on the app ac
getAccountsByOwner(owner: string): Promise&lt;Array&lt;AppAccountInfo&gt;&gt; getAccountsByOwner(owner: string): Promise&lt;Array&lt;AppAccountInfo&gt;&gt;
Obtains the app accounts that can be accessed by the invoker based on the app account owner. This API uses a promise to return the result. Obtains the app accounts that can be accessed by the invoker based on the app account owner. This API uses a promise to return the result.
**Required permissions**: ohos.permission.GET_ALL_APP_ACCOUNTS
**System capability**: SystemCapability.Account.AppAccount **System capability**: SystemCapability.Account.AppAccount
...@@ -1292,7 +1285,7 @@ Subscribes to account information changes of apps. ...@@ -1292,7 +1285,7 @@ Subscribes to account information changes of apps.
### off('accountChange')<sup>9+</sup> ### off('accountChange')<sup>9+</sup>
off(type: 'accountChange', callback?: Callback<Array\<AppAccountInfo>>): void off(type: 'accountChange', callback?: Callback&lt;Array&lt;AppAccountInfo&gt;&gt;): void
Unsubscribes from account information changes. Unsubscribes from account information changes.
...@@ -1303,7 +1296,7 @@ Unsubscribes from account information changes. ...@@ -1303,7 +1296,7 @@ Unsubscribes from account information changes.
| Name | Type | Mandatory | Description | | Name | Type | Mandatory | Description |
| -------- | -------------------------------- | ---- | ------------ | | -------- | -------------------------------- | ---- | ------------ |
| type | 'accountChange' | Yes | Event type to unsubscribe from. The value is **'accountChange'**. | | type | 'accountChange' | Yes | Event type to unsubscribe from. The value is **'accountChange'**. |
| callback | Callback<Array\<[AppAccountInfo](#appaccountinfo)>> | No | Callback to unregister.| | callback | Callback&lt;Array&lt;[AppAccountInfo](#appaccountinfo)&gt;&gt; | No | Callback to unregister.|
**Error codes** **Error codes**
...@@ -2782,7 +2775,8 @@ addAccount(name: string, extraInfo?: string): Promise&lt;void&gt; ...@@ -2782,7 +2775,8 @@ addAccount(name: string, extraInfo?: string): Promise&lt;void&gt;
Adds an app account name and additional information. This API uses an asynchronous callback to return the result. This API uses a promise to return the result. Adds an app account name and additional information. This API uses an asynchronous callback to return the result. This API uses a promise to return the result.
> **NOTE**<br> > **NOTE**
>
> This API is supported since API version 7 and deprecated since API version 9. You are advised to use [createAccount](#createaccount9-2). > This API is supported since API version 7 and deprecated since API version 9. You are advised to use [createAccount](#createaccount9-2).
**System capability**: SystemCapability.Account.AppAccount **System capability**: SystemCapability.Account.AppAccount
...@@ -3730,7 +3724,7 @@ Subscribes to account information changes of apps. ...@@ -3730,7 +3724,7 @@ Subscribes to account information changes of apps.
### off('change')<sup>(deprecated)</sup> ### off('change')<sup>(deprecated)</sup>
off(type: 'change', callback?: Callback<Array\<AppAccountInfo>>): void off(type: 'change', callback?: Callback&lt;Array&lt;AppAccountInfo&gt;&gt;): void
Unsubscribes from account information changes. Unsubscribes from account information changes.
...@@ -3745,7 +3739,7 @@ Unsubscribes from account information changes. ...@@ -3745,7 +3739,7 @@ Unsubscribes from account information changes.
| Name | Type | Mandatory | Description | | Name | Type | Mandatory | Description |
| -------- | -------------------------------- | ---- | ------------ | | -------- | -------------------------------- | ---- | ------------ |
| type | 'change' | Yes | Event type to unsubscribe from. The value is **'change'**, which indicates the account change event. | | type | 'change' | Yes | Event type to unsubscribe from. The value is **'change'**, which indicates the account change event. |
| callback | Callback<Array\<[AppAccountInfo](#appaccountinfo)>> | No | Callback to unregister.| | callback | Callback&lt;Array&lt;[AppAccountInfo](#appaccountinfo)&gt;&gt; | No | Callback to unregister.|
**Example** **Example**
......
...@@ -326,9 +326,9 @@ Checks whether the specified constraint is enabled for an OS account. This API u ...@@ -326,9 +326,9 @@ Checks whether the specified constraint is enabled for an OS account. This API u
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId. | | 12300002 | invalid localId or constraint. |
| 12300003 | Account not found. | | 12300003 | the account indicated by localId dose not exist. |
**Example**: Check whether OS account 100 is forbidden to use Wi-Fi. **Example**: Check whether OS account 100 is forbidden to use Wi-Fi.
...@@ -376,9 +376,9 @@ Checks whether the specified constraint is enabled for an OS account. This API u ...@@ -376,9 +376,9 @@ Checks whether the specified constraint is enabled for an OS account. This API u
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId. | | 12300002 | invalid localId or constraint. |
| 12300003 | Account not found. | | 12300003 | the account indicated by localId dose not exist. |
**Example**: Check whether OS account 100 is forbidden to use Wi-Fi. **Example**: Check whether OS account 100 is forbidden to use Wi-Fi.
...@@ -475,23 +475,19 @@ checkOsAccountVerified(callback: AsyncCallback&lt;boolean&gt;): void ...@@ -475,23 +475,19 @@ checkOsAccountVerified(callback: AsyncCallback&lt;boolean&gt;): void
Checks whether this OS account has been verified. This API uses an asynchronous callback to return the result. Checks whether this OS account has been verified. This API uses an asynchronous callback to return the result.
**Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS or ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
**System capability**: SystemCapability.Account.OsAccount **System capability**: SystemCapability.Account.OsAccount
**Parameters** **Parameters**
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | ---------------------------- | ---- | ------------------------------------------------------------- | | -------- | ---------------------------- | ---- | ------------------------------------------------------------- |
| callback | AsyncCallback&lt;boolean&gt; | Yes | Callback invoked to return the result. If true is returned, the current account has been verified. If false is returned, the current account has not been verified.| | callback | AsyncCallback&lt;boolean&gt; | Yes | Callback invoked to return the result. The value **true** means the OS account has been verified; the value **false** means the opposite.|
**Error codes** **Error codes**
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId. |
| 12300003 | Account not found. |
**Example** **Example**
...@@ -531,9 +527,9 @@ Checks whether an OS account has been verified. This API uses an asynchronous ca ...@@ -531,9 +527,9 @@ Checks whether an OS account has been verified. This API uses an asynchronous ca
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId. | | 12300002 | invalid localId. |
| 12300003 | Account not found. | | 12300003 | the account indicated by localId dose not exist. |
**Example** **Example**
...@@ -555,7 +551,7 @@ Checks whether an OS account has been verified. This API uses an asynchronous ca ...@@ -555,7 +551,7 @@ Checks whether an OS account has been verified. This API uses an asynchronous ca
### checkOsAccountVerified<sup>9+</sup> ### checkOsAccountVerified<sup>9+</sup>
checkOsAccountVerified(localId?: number): Promise&lt;boolean&gt; checkOsAccountVerified(localId: number): Promise&lt;boolean&gt;
Checks whether an OS account has been verified. This API uses a promise to return the result. Checks whether an OS account has been verified. This API uses a promise to return the result.
...@@ -567,7 +563,7 @@ Checks whether an OS account has been verified. This API uses a promise to retur ...@@ -567,7 +563,7 @@ Checks whether an OS account has been verified. This API uses a promise to retur
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| ------- | ------ | ---- | --------------------------------------------------------------- | | ------- | ------ | ---- | --------------------------------------------------------------- |
| localId | number | No | ID of the target OS account. If this parameter is not specified, this API checks whether the current OS account has been verified.| | localId | number | Yes | ID of the target OS account.|
**Return value** **Return value**
...@@ -579,9 +575,9 @@ Checks whether an OS account has been verified. This API uses a promise to retur ...@@ -579,9 +575,9 @@ Checks whether an OS account has been verified. This API uses a promise to retur
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId. | | 12300002 | invalid localId. |
| 12300003 | Account not found. | | 12300003 | the account indicated by localId dose not exist. |
**Example** **Example**
...@@ -991,7 +987,7 @@ Obtains the ID of the OS account to which the current process belongs. This API ...@@ -991,7 +987,7 @@ Obtains the ID of the OS account to which the current process belongs. This API
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
**Example** **Example**
...@@ -1028,7 +1024,7 @@ Obtains the ID of the OS account to which the current process belongs. This API ...@@ -1028,7 +1024,7 @@ Obtains the ID of the OS account to which the current process belongs. This API
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
**Example** **Example**
...@@ -1064,8 +1060,8 @@ Obtains the OS account ID based on the process UID. This API uses an asynchronou ...@@ -1064,8 +1060,8 @@ Obtains the OS account ID based on the process UID. This API uses an asynchronou
| ID| Error Message | | ID| Error Message |
| -------- | --------------- | | -------- | --------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid uid. | | 12300002 | invalid uid. |
**Example**: Obtain the ID of the OS account whose process UID is **12345678**. **Example**: Obtain the ID of the OS account whose process UID is **12345678**.
...@@ -1108,8 +1104,8 @@ Obtains the OS account ID based on the process UID. This API uses a promise to r ...@@ -1108,8 +1104,8 @@ Obtains the OS account ID based on the process UID. This API uses a promise to r
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid uid. | | 12300002 | invalid uid. |
**Example**: Obtain the ID of the OS account whose process UID is **12345678**. **Example**: Obtain the ID of the OS account whose process UID is **12345678**.
...@@ -1148,8 +1144,8 @@ Obtains the OS account ID based on the domain account information. This API uses ...@@ -1148,8 +1144,8 @@ Obtains the OS account ID based on the domain account information. This API uses
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid domainInfo. | | 12300002 | invalid domainInfo. |
**Example** **Example**
...@@ -1195,8 +1191,8 @@ Obtains the OS account ID based on the domain account information. This API uses ...@@ -1195,8 +1191,8 @@ Obtains the OS account ID based on the domain account information. This API uses
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid domainInfo. | | 12300002 | invalid domainInfo. |
**Example** **Example**
...@@ -1474,7 +1470,7 @@ Obtains information about all activated OS accounts. This API uses an asynchrono ...@@ -1474,7 +1470,7 @@ Obtains information about all activated OS accounts. This API uses an asynchrono
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
**Example** **Example**
...@@ -1511,7 +1507,7 @@ Obtains information about all activated OS accounts. This API uses a promise to ...@@ -1511,7 +1507,7 @@ Obtains information about all activated OS accounts. This API uses a promise to
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
**Example** **Example**
...@@ -2233,9 +2229,9 @@ Obtains the OS account ID based on the serial number (SN). This API uses an asyn ...@@ -2233,9 +2229,9 @@ Obtains the OS account ID based on the serial number (SN). This API uses an asyn
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid serialNumber. | | 12300002 | invalid serialNumber. |
| 12300003 | Account not found. | | 12300003 | the account indicated by serialNumber dose not exist. |
**Example**: Obtain the ID of the OS account whose SN is 12345. **Example**: Obtain the ID of the OS account whose SN is 12345.
...@@ -2276,9 +2272,9 @@ Obtains the OS account ID based on the SN. This API uses a promise to return the ...@@ -2276,9 +2272,9 @@ Obtains the OS account ID based on the SN. This API uses a promise to return the
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid serialNumber. | | 12300002 | invalid serialNumber. |
| 12300003 | Account not found. | | 12300003 | the account indicated by serialNumber dose not exist. |
**Example**: Obtain the ID of the OS account whose SN is 12345. **Example**: Obtain the ID of the OS account whose SN is 12345.
...@@ -2315,9 +2311,9 @@ Obtains the SN of an OS account based on the account ID. This API uses an asynch ...@@ -2315,9 +2311,9 @@ Obtains the SN of an OS account based on the account ID. This API uses an asynch
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId. | | 12300002 | invalid localId. |
| 12300003 | Account not found. | | 12300003 | the account indicated by localId dose not exist. |
**Example**: Obtain the SN of the OS account 100. **Example**: Obtain the SN of the OS account 100.
...@@ -2358,9 +2354,9 @@ Obtains the SN of an OS account based on the account ID. This API uses a promise ...@@ -2358,9 +2354,9 @@ Obtains the SN of an OS account based on the account ID. This API uses a promise
| ID| Error Message | | ID| Error Message |
| -------- | ------------------- | | -------- | ------------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId. | | 12300002 | invalid localId. |
| 12300003 | Account not found. | | 12300003 | the account indicated by localId dose not exist. |
**Example**: Obtain the SN of the OS account 100. **Example**: Obtain the SN of the OS account 100.
...@@ -2394,7 +2390,7 @@ Subscribes to the OS account activation states, including the states of the acco ...@@ -2394,7 +2390,7 @@ Subscribes to the OS account activation states, including the states of the acco
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| -------- | -------------------------- | ---- | ------------------------------------------------------------ | | -------- | -------------------------- | ---- | ------------------------------------------------------------ |
| type | 'activate' \| 'activating' | Yes | Type of the event to subscribe to. The value **activate** indicates an event reported when the OS account activation is complete, and **activating** indicates an event reported when OS account is being activated.| | type | 'activate' \| 'activating' | Yes | Type of the event to subscribe to. The value **activate** means an event indicating that an OS account is activated, and **activating** means an event indicating that an OS account is being activated.|
| name | string | Yes | Subscription name, which can be customized. The value cannot be empty or exceed 1024 bytes. | | name | string | Yes | Subscription name, which can be customized. The value cannot be empty or exceed 1024 bytes. |
| callback | Callback&lt;number&gt; | Yes | Callback invoked to return the ID of the OS account being activated or activated. | | callback | Callback&lt;number&gt; | Yes | Callback invoked to return the ID of the OS account being activated or activated. |
...@@ -2483,8 +2479,8 @@ Obtains the bundle ID based on the UID. This API uses an asynchronous callback t ...@@ -2483,8 +2479,8 @@ Obtains the bundle ID based on the UID. This API uses an asynchronous callback t
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid uid. | | 12300002 | invalid uid. |
**Example** **Example**
...@@ -2526,8 +2522,8 @@ Obtains the bundle ID based on the UID. This API uses a promise to return the re ...@@ -2526,8 +2522,8 @@ Obtains the bundle ID based on the UID. This API uses a promise to return the re
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid uid. | | 12300002 | invalid uid. |
**Example** **Example**
...@@ -2644,9 +2640,9 @@ Obtains the constraint source information of an OS account. This API uses an asy ...@@ -2644,9 +2640,9 @@ Obtains the constraint source information of an OS account. This API uses an asy
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId or constraint. | | 12300002 | invalid name or constraint. |
| 12300003 | Account not found. | | 12300003 | the account indicated by localId dose not exist. |
**Example** **Example**
...@@ -2691,9 +2687,9 @@ Obtains the constraint source information of an OS account. This API uses a prom ...@@ -2691,9 +2687,9 @@ Obtains the constraint source information of an OS account. This API uses a prom
| ID| Error Message | | ID| Error Message |
| -------- | ------------- | | -------- | ------------- |
| 12300001 | System service exception. | | 12300001 | system service exception. |
| 12300002 | Invalid localId or constraint. | | 12300002 | invalid name or constraint. |
| 12300003 | Account not found. | | 12300003 | the account indicated by localId dose not exist. |
**Example** **Example**
...@@ -4328,6 +4324,122 @@ Unregisters this PIN inputer. ...@@ -4328,6 +4324,122 @@ Unregisters this PIN inputer.
pinAuth.unregisterInputer(); pinAuth.unregisterInputer();
``` ```
## DomainPlugin<sup>9+</sup>
Provides APIs for domain account authentication.
**System API**: This is a system API.
### auth<sup>9+</sup>
auth(domainAccountInfo: DomainAccountInfo, credential: Uint8Array, callback: IUserAuthCallback): void
Authenticates a domain account.
**System API**: This is a system API.
**System capability**: SystemCapability.Account.OsAccount
**Parameters**
| Name | Type | Mandatory| Description |
| ---------- | --------------------------------------- | ---- | --------------- |
| domainAccountInfo | [DomainAccountInfo](#domainaccountinfo8) | Yes | Domain account information.|
| credential | Uint8Array | Yes | Credentials of the domain account.|
| callback | [IUserAuthCallback](#iuserauthcallback8) | Yes | Callback invoked to return the authentication result.|
**Example**
```js
let plugin = {
auth: (domainAccountInfo, credential, callback) => {
// mock authentication
// notify authentication result
callback.onResult(0, {
token: new Uint8Array([0]),
remainTimes: 5,
freezingTime: 0
});
}
}
account_osAccount.DomainAccountManager.registerPlugin(plugin);
let userAuth = new account_osAccount.UserAuth();
let challenge = new Uint8Array([0]);
let authType = account_osAccount.AuthType.DOMAIN;
let authTrustLevel = account_osAccount.AuthTrustLevel.ATL1;
try {
userAuth.auth(challenge, authType, authTrustLevel, {
onResult: (resultCode, authResult) => {
console.log('auth resultCode = ' + resultCode);
console.log('auth authResult = ' + JSON.stringify(authResult));
}
});
} catch (err) {
console.log('auth exception = ' + JSON.stringify(err));
}
```
## DomainAccountManager <sup>9+</sup>
Provides APIs for domain account management.
### registerPlugin<sup>9+</sup>
static registerPlugin(plugin: DomainPlugin): void
Registers a domain plug-in.
**System API**: This is a system API.
**System capability**: SystemCapability.Account.OsAccount
**Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS
**Parameters**
| Name | Type | Mandatory| Description |
| ----------| ----------------------- | --- | -------------------------- |
| plugin | [DomainPlugin](#domainplugin9) | Yes | Domain plug-in to register.|
**Error codes**
| ID| Error Message |
| -------- | --------------------------- |
| 12300201 | the domain plugin has been registered. |
**Example**
```js
let plugin = {
auth: (domainAccountInfo, credential, callback) => {}
}
try {
account_osAccount.DomainAccountManager.registerPlugin(plugin);
console.log('registerPlugin success.');
} catch(err) {
console.log("registerPlugin err:" + JSON.stringify(err));
}
```
### unregisterPlugin<sup>9+</sup>
static unregisterPlugin(): void
Unregisters this domain plug-in.
**System API**: This is a system API.
**System capability**: SystemCapability.Account.OsAccount
**Required permissions**: ohos.permission.MANAGE_LOCAL_ACCOUNTS
**Example**
```js
try {
account_osAccount.DomainAccountManager.unregisterPlugin();
console.log('unregisterPlugin success.');
} catch(err) {
console.log("unregisterPlugin err:" + JSON.stringify(err));
}
```
## UserIdentityManager<sup>8+</sup> ## UserIdentityManager<sup>8+</sup>
Provides APIs for user identity management (IDM). Provides APIs for user identity management (IDM).
...@@ -4821,7 +4933,7 @@ Provides callbacks for PIN operations. ...@@ -4821,7 +4933,7 @@ Provides callbacks for PIN operations.
### onSetData<sup>8+</sup> ### onSetData<sup>8+</sup>
onSetData: (pinSubType: AuthSubType, data: Uint8Array) => void; onSetData: (authSubType: AuthSubType, data: Uint8Array) => void;
**System API**: This is a system API. **System API**: This is a system API.
...@@ -4833,7 +4945,7 @@ Called to set data in a PIN operation. ...@@ -4833,7 +4945,7 @@ Called to set data in a PIN operation.
| Name | Type | Mandatory| Description | | Name | Type | Mandatory| Description |
| ---------- | ---------------------------------------- | ---- | ----------------------------------------------- | | ---------- | ---------------------------------------- | ---- | ----------------------------------------------- |
| pinSubType | [AuthSubType](#authsubtype8) | Yes | Credential subtype. | | authSubType | [AuthSubType](#authsubtype8) | Yes | Credential subtype. |
| data | Uint8Array | Yes | Data (credential) to set. The data is used for authentication and operations for adding and modifying credentials.| | data | Uint8Array | Yes | Data (credential) to set. The data is used for authentication and operations for adding and modifying credentials.|
**Example** **Example**
...@@ -4841,11 +4953,11 @@ Called to set data in a PIN operation. ...@@ -4841,11 +4953,11 @@ Called to set data in a PIN operation.
let password = new Uint8Array([0, 0, 0, 0, 0, 0]); let password = new Uint8Array([0, 0, 0, 0, 0, 0]);
let passwordNumber = new Uint8Array([1, 2, 3, 4]); let passwordNumber = new Uint8Array([1, 2, 3, 4]);
let inputer = { let inputer = {
onGetData: (pinSubType, callback) => { onGetData: (authSubType, callback) => {
if (pinSubType == account_osAccount.AuthSubType.PIN_NUMBER) { if (authSubType == account_osAccount.AuthSubType.PIN_NUMBER) {
callback.onSetData(pinSubType, passwordNumber); callback.onSetData(authSubType, passwordNumber);
} else { } else {
callback.onSetData(pinSubType, password); callback.onSetData(authSubType, password);
} }
} }
}; };
...@@ -4859,7 +4971,7 @@ Provides callbacks for the PIN input box. ...@@ -4859,7 +4971,7 @@ Provides callbacks for the PIN input box.
### onGetData<sup>8+</sup> ### onGetData<sup>8+</sup>
onGetData: (pinSubType: AuthSubType, callback: IInputData) => void; onGetData: (authSubType: AuthSubType, callback: IInputData) => void;
Called to obtain data. Called to obtain data.
...@@ -4878,11 +4990,11 @@ Called to obtain data. ...@@ -4878,11 +4990,11 @@ Called to obtain data.
let password = new Uint8Array([0, 0, 0, 0, 0, 0]); let password = new Uint8Array([0, 0, 0, 0, 0, 0]);
let passwordNumber = new Uint8Array([1, 2, 3, 4]); let passwordNumber = new Uint8Array([1, 2, 3, 4]);
let inputer = { let inputer = {
onGetData: (pinSubType, callback) => { onGetData: (authSubType, callback) => {
if (pinSubType == account_osAccount.AuthSubType.PIN_NUMBER) { if (authSubType == account_osAccount.AuthSubType.PIN_NUMBER) {
callback.onSetData(pinSubType, passwordNumber); callback.onSetData(authSubType, passwordNumber);
} else { } else {
callback.onSetData(pinSubType, password); callback.onSetData(authSubType, password);
} }
} }
}; };
...@@ -5158,6 +5270,7 @@ Enumerates the authentication credential types. ...@@ -5158,6 +5270,7 @@ Enumerates the authentication credential types.
| ----- | ----- | ---------------- | | ----- | ----- | ---------------- |
| PIN | 1 | PIN authentication.| | PIN | 1 | PIN authentication.|
| FACE | 2 | Facial authentication.| | FACE | 2 | Facial authentication.|
| DOMAIN<sup>9+</sup> | 1024 | Domain authentication.|
## AuthSubType<sup>8+</sup> ## AuthSubType<sup>8+</sup>
...@@ -5174,6 +5287,7 @@ Enumerates the authentication credential subtypes. ...@@ -5174,6 +5287,7 @@ Enumerates the authentication credential subtypes.
| PIN_MIXED | 10002 | Custom mixed credentials.| | PIN_MIXED | 10002 | Custom mixed credentials.|
| FACE_2D | 20000 | 2D face credential. | | FACE_2D | 20000 | 2D face credential. |
| FACE_3D | 20001 | 3D face credential. | | FACE_3D | 20001 | 3D face credential. |
| DOMAIN_MIXED<sup>9+</sup> | 10240001 | Mixed domain authentication credentials. |
## AuthTrustLevel<sup>8+</sup> ## AuthTrustLevel<sup>8+</sup>
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册