本模塊提供管理系統(tǒng)帳號(hào)的基礎(chǔ)能力,包括系統(tǒng)帳號(hào)的添加、刪除、查詢、設(shè)置、訂閱、啟動(dòng)等功能。
本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口,采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。
getAccountManager(): AccountManager
獲取系統(tǒng)帳號(hào)管理對(duì)象。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
系統(tǒng)帳號(hào)管理對(duì)象。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
表示系統(tǒng)帳號(hào)類型的枚舉。
系統(tǒng)能力: SystemCapability.Account.OsAccount。
名稱 | 值 | 說明 |
---|---|---|
ADMIN | 0 | 管理員帳號(hào)。 |
NORMAL | 1 | 普通帳號(hào)。 |
GUEST | 2 | 訪客帳號(hào)。 |
checkMultiOsAccountEnabled(callback: AsyncCallback<boolean>): void
判斷是否支持多系統(tǒng)帳號(hào)。使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示支持多系統(tǒng)帳號(hào);返回false表示不支持。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.checkMultiOsAccountEnabled((err, isEnabled) => {
- if (err) {
- console.log("checkMultiOsAccountEnabled failed, error: " + JSON.stringify(err));
- } else {
- console.log("checkMultiOsAccountEnabled successfully, isEnabled: " + isEnabled);
- }
- });
- } catch (err) {
- console.log("checkMultiOsAccountEnabled exception: " + JSON.stringify(err));
- }
checkMultiOsAccountEnabled(): Promise<boolean>
判斷是否支持多系統(tǒng)帳號(hào)。使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示支持多系統(tǒng)帳號(hào);返回false表示不支持。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- try {
- let accountManager = account_osAccount.getAccountManager();
- accountManager.checkMultiOsAccountEnabled().then((isEnabled) => {
- console.log('checkMultiOsAccountEnabled successfully, isEnabled: ' + isEnabled);
- }).catch((err) => {
- console.log('checkMultiOsAccountEnabled failed, error: ' + JSON.stringify(err));
- });
- } catch (err) {
- console.log('checkMultiOsAccountEnabled exception: ' + JSON.stringify(err));
- }
checkOsAccountActivated(localId: number, callback: AsyncCallback<boolean>): void
判斷指定系統(tǒng)帳號(hào)是否處于激活狀態(tài)。使用callback異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示帳號(hào)已激活;返回false表示帳號(hào)未激活。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
12300002 | Invalid localId. |
12300003 | Account not found. |
示例: 判斷ID為100的系統(tǒng)帳號(hào)是否處于激活狀態(tài)
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- try {
- accountManager.checkOsAccountActivated(localId, (err, isActivated) => {
- if (err) {
- console.log('checkOsAccountActivated failed, error:' + JSON.stringify(err));
- } else {
- console.log('checkOsAccountActivated successfully, isActivated:' + isActivated);
- }
- });
- } catch (err) {
- console.log('checkOsAccountActivated exception:' + JSON.stringify(err));
- }
checkOsAccountActivated(localId: number): Promise<boolean>
判斷指定系統(tǒng)帳號(hào)是否處于激活狀態(tài)。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示帳號(hào)已激活;返回false表示帳號(hào)未激活。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
12300002 | Invalid localId. |
12300003 | Account not found. |
示例: 判斷ID為100的系統(tǒng)帳號(hào)是否處于激活狀態(tài)
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- try {
- accountManager.checkOsAccountActivated(localId).then((isActivated) => {
- console.log('checkOsAccountActivated successfully, isActivated: ' + isActivated);
- }).catch((err) => {
- console.log('checkOsAccountActivated failed, error: ' + JSON.stringify(err));
- });
- } catch (err) {
- console.log('checkOsAccountActivated exception:' + JSON.stringify(err));
- }
checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void
判斷指定系統(tǒng)帳號(hào)是否具有指定約束。使用callback異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
constraint | string | 是 | 指定的約束名稱。 |
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示已使能指定的約束;返回false表示未使能指定的約束。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid localId or constraint. |
12300003 | the account indicated by localId dose not exist. |
示例: 判斷ID為100的系統(tǒng)帳號(hào)是否有禁止使用Wi-Fi的約束
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- let constraint = "constraint.wifi";
- try {
- accountManager.checkOsAccountConstraintEnabled(localId, constraint, (err, isEnabled)=>{
- if (err) {
- console.log("checkOsAccountConstraintEnabled failed, error: " + JSON.stringify(err));
- } else {
- console.log("checkOsAccountConstraintEnabled successfully, isEnabled: " + isEnabled);
- }
- });
- } catch (err) {
- console.log("checkOsAccountConstraintEnabled exception: " + JSON.stringify(err));
- }
checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>
判斷指定系統(tǒng)帳號(hào)是否具有指定約束。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
constraint | string | 是 | 指定的約束名稱。 |
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示已使能指定的約束;返回false表示未使能指定的約束。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid localId or constraint. |
12300003 | the account indicated by localId dose not exist. |
示例: 判斷ID為100的系統(tǒng)帳號(hào)是否有禁止使用Wi-Fi的約束
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- let constraint = "constraint.wifi";
- try {
- accountManager.checkOsAccountConstraintEnabled(localId, constraint).then((isEnabled) => {
- console.log("checkOsAccountConstraintEnabled successfully, isEnabled: " + isEnabled);
- }).catch((err) => {
- console.log("checkOsAccountConstraintEnabled failed, error: " + JSON.stringify(err));
- });
- } catch (err) {
- console.log("checkOsAccountConstraintEnabled exception: " + JSON.stringify(err));
- }
checkOsAccountTestable(callback: AsyncCallback<boolean>): void
檢查當(dāng)前系統(tǒng)帳號(hào)是否為測試帳號(hào)。使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示當(dāng)前帳號(hào)為測試帳號(hào);返回false表示當(dāng)前帳號(hào)非測試帳號(hào)。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.checkOsAccountTestable((err, isTestable) => {
- if (err) {
- console.log("checkOsAccountTestable failed, error: " + JSON.stringify(err));
- } else {
- console.log("checkOsAccountTestable successfully, isTestable: " + isTestable);
- }
- });
- } catch (err) {
- console.log("checkOsAccountTestable error: " + JSON.stringify(err));
- }
checkOsAccountTestable(): Promise<boolean>
檢查當(dāng)前系統(tǒng)帳號(hào)是否為測試帳號(hào)。使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示當(dāng)前帳號(hào)為測試帳號(hào);返回false表示當(dāng)前帳號(hào)非測試帳號(hào)。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.checkOsAccountTestable().then((isTestable) => {
- console.log("checkOsAccountTestable successfully, isTestable: " + isTestable);
- }).catch((err) => {
- console.log("checkOsAccountTestable failed, error: " + JSON.stringify(err));
- });
- } catch (err) {
- console.log('checkOsAccountTestable exception: ' + JSON.stringify(err));
- }
checkOsAccountVerified(callback: AsyncCallback<boolean>): void
檢查當(dāng)前系統(tǒng)帳號(hào)是否已驗(yàn)證。使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示當(dāng)前帳號(hào)已驗(yàn)證;返回false表示當(dāng)前帳號(hào)未驗(yàn)證。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.checkOsAccountVerified((err, isVerified) => {
- if (err) {
- console.log("checkOsAccountVerified failed, error: " + JSON.stringify(err));
- } else {
- console.log("checkOsAccountVerified successfully, isVerified: " + isVerified);
- }
- });
- } catch (err) {
- console.log("checkOsAccountVerified exception: " + JSON.stringify(err));
- }
checkOsAccountVerified(localId: number, callback: AsyncCallback<boolean>): void
檢查指定系統(tǒng)帳號(hào)是否已驗(yàn)證。使用callback異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示指定帳號(hào)已驗(yàn)證;返回false表示指定帳號(hào)未驗(yàn)證。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid localId. |
12300003 | the account indicated by localId dose not exist. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- try {
- accountManager.checkOsAccountVerified(localId, (err, isVerified) => {
- if (err) {
- console.log("checkOsAccountVerified failed, error: " + JSON.stringify(err));
- } else {
- console.log("checkOsAccountVerified successfully, isVerified: " + isVerified);
- }
- });
- } catch (err) {
- console.log("checkOsAccountVerified exception: " + err);
- }
checkOsAccountVerified(localId: number): Promise<boolean>
檢查指定系統(tǒng)帳號(hào)是否已驗(yàn)證。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示指定帳號(hào)已驗(yàn)證;返回false表示指定帳號(hào)未驗(yàn)證。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid localId. |
12300003 | the account indicated by localId dose not exist. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- try {
- accountManager.checkOsAccountVerified(localId).then((isVerified) => {
- console.log("checkOsAccountVerified successfully, isVerified: " + isVerified);
- }).catch((err) => {
- console.log("checkOsAccountVerified failed, error: " + JSON.stringify(err));
- });
- } catch (err) {
- console.log('checkOsAccountVerified exception: ' + JSON.stringify(err));
- }
getOsAccountCount(callback: AsyncCallback<number>): void
獲取已創(chuàng)建的系統(tǒng)帳號(hào)數(shù)量。使用callback異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。當(dāng)獲取成功時(shí),err為null,data為已創(chuàng)建的系統(tǒng)帳號(hào)的數(shù)量;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getOsAccountCount((err, count) => {
- if (err) {
- console.log("getOsAccountCount failed, error: " + JSON.stringify(err));
- } else {
- console.log("getOsAccountCount successfully, count: " + count);
- }
- });
- } catch (err) {
- console.log("getOsAccountCount exception: " + JSON.stringify(err));
- }
getOsAccountCount(): Promise<number>
獲取已創(chuàng)建的系統(tǒng)帳號(hào)數(shù)量。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回已創(chuàng)建的系統(tǒng)帳號(hào)的數(shù)量。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getOsAccountCount().then((count) => {
- console.log("getOsAccountCount successfully, count: " + count);
- }).catch((err) => {
- console.log("getOsAccountCount failed, error: " + JSON.stringify(err));
- });
- } catch(err) {
- console.log('getOsAccountCount exception:' + JSON.stringify(err));
- }
getOsAccountLocalId(callback: AsyncCallback<number>): void
獲取當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)ID,使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。當(dāng)獲取成功時(shí),err為null,data為當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)ID;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getOsAccountLocalId((err, localId) => {
- if (err) {
- console.log("getOsAccountLocalId failed, error: " + JSON.stringify(err));
- } else {
- console.log("getOsAccountLocalId successfully, localId: " + localId);
- }
- });
- } catch (err) {
- console.log("getOsAccountLocalId exception: " + JSON.stringify(err));
- }
getOsAccountLocalId(): Promise<number>
獲取當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)ID,使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)ID。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getOsAccountLocalId().then((localId) => {
- console.log("getOsAccountLocalId successfully, localId: " + localId);
- }).catch((err) => {
- console.log("getOsAccountLocalId failed, error: " + JSON.stringify(err));
- });
- } catch (err) {
- console.log('getOsAccountLocalId exception: ' + JSON.stringify(err));
- }
getOsAccountLocalIdForUid(uid: number, callback: AsyncCallback<number>): void
根據(jù)uid查詢對(duì)應(yīng)的系統(tǒng)帳號(hào)ID,使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
uid | number | 是 | 進(jìn)程uid。 |
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為對(duì)應(yīng)的系統(tǒng)帳號(hào)ID;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid uid. |
示例: 查詢值為12345678的uid所屬的系統(tǒng)帳號(hào)的帳號(hào)ID
- let accountManager = account_osAccount.getAccountManager();
- let uid = 12345678;
- try {
- accountManager.getOsAccountLocalIdForUid(uid, (err, localId) => {
- if (err) {
- console.log("getOsAccountLocalIdForUid failed, error: " + JSON.stringify(err));
- }
- console.log("getOsAccountLocalIdForUid successfully, localId: " + localId);
- });
- } catch (err) {
- console.log("getOsAccountLocalIdForUid exception: " + JSON.stringify(err));
- }
getOsAccountLocalIdForUid(uid: number): Promise<number>
根據(jù)uid查詢對(duì)應(yīng)的系統(tǒng)帳號(hào)ID,使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
uid | number | 是 | 進(jìn)程uid。 |
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回指定uid對(duì)應(yīng)的系統(tǒng)帳號(hào)ID。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid uid. |
示例: 查詢值為12345678的uid所屬的系統(tǒng)帳號(hào)ID
- let accountManager = account_osAccount.getAccountManager();
- let uid = 12345678;
- try {
- accountManager.getOsAccountLocalIdForUid(uid).then((localId) => {
- console.log("getOsAccountLocalIdForUid successfully, localId: " + localId);
- }).catch((err) => {
- console.log("getOsAccountLocalIdForUid failed, error: " + JSON.stringify(err));
- });
- } catch (err) {
- console.log('getOsAccountLocalIdForUid exception: ' + JSON.stringify(err));
- }
getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void
根據(jù)域帳號(hào)信息,獲取與其關(guān)聯(lián)的系統(tǒng)帳號(hào)ID。使用callback異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
domainInfo | 是 | 域帳號(hào)信息。 | |
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為域帳號(hào)關(guān)聯(lián)的系統(tǒng)帳號(hào)ID;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid domainInfo. |
示例:
- let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getOsAccountLocalIdForDomain(domainInfo, (err, localId) => {
- if (err) {
- console.log("getOsAccountLocalIdForDomain failed, error: " + JSON.stringify(err));
- } else {
- console.log("getOsAccountLocalIdForDomain successfully, localId: " + localId);
- }
- });
- } catch (err) {
- console.log('getOsAccountLocalIdForDomain exception: ' + JSON.stringify(err));
- }
getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo): Promise<number>
根據(jù)域帳號(hào)信息,獲取與其關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
domainInfo | 是 | 域帳號(hào)信息。 |
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回域帳號(hào)關(guān)聯(lián)的系統(tǒng)帳號(hào)ID。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid domainInfo. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
- try {
- accountManager.getOsAccountLocalIdForDomain(domainInfo).then((localId) => {
- console.log("getOsAccountLocalIdForDomain successfully, localId: " + localId);
- }).catch((err) => {
- console.log("getOsAccountLocalIdForDomain failed, error: " + JSON.stringify(err));
- });
- } catch (err) {
- console.log("getOsAccountLocalIdForDomain exception: " + JSON.stringify(err));
- }
getOsAccountConstraints(localId: number, callback: AsyncCallback<Array<string>>): void
獲取指定系統(tǒng)帳號(hào)的全部約束。使用callback異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
callback | AsyncCallback<Array<string>> | 是 | 回調(diào)函數(shù),如果獲取成功,err為null,data為該系統(tǒng)帳號(hào)的全部約束;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
12300002 | Invalid localId. |
12300003 | Account not found. |
示例: 獲取ID為100的系統(tǒng)帳號(hào)的全部約束
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- try {
- accountManager.getOsAccountConstraints(localId, (err, constraints) => {
- if (err) {
- console.log("getOsAccountConstraints failed, err: " + JSON.stringify(err));
- } else {
- console.log("getOsAccountConstraints successfully, constraints: " + JSON.stringify(constraints));
- }
- });
- } catch (err) {
- console.log('getOsAccountConstraints exception:' + JSON.stringify(err));
- }
getOsAccountConstraints(localId: number): Promise<Array<string>>
獲取指定系統(tǒng)帳號(hào)的全部約束。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
返回值:
類型 | 說明 |
---|---|
Promise<Array<string>> | Promise對(duì)象,返回指定系統(tǒng)帳號(hào)的全部約束。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
12300002 | Invalid localId. |
12300003 | Account not found. |
示例: 獲取ID為100的系統(tǒng)帳號(hào)的全部約束
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- try {
- accountManager.getOsAccountConstraints(localId).then((constraints) => {
- console.log('getOsAccountConstraints, constraints: ' + constraints);
- }).catch((err) => {
- console.log('getOsAccountConstraints err: ' + JSON.stringify(err));
- });
- } catch (e) {
- console.log('getOsAccountConstraints exception:' + JSON.stringify(e));
- }
getActivatedOsAccountLocalIds(callback: AsyncCallback<Array<number>>): void
查詢當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號(hào)的ID列表。使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<Array<number>> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號(hào)的ID列表;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getActivatedOsAccountLocalIds((err, idArray)=>{
- console.log('getActivatedOsAccountLocalIds err:' + JSON.stringify(err));
- console.log('getActivatedOsAccountLocalIds idArray length:' + idArray.length);
- for(let i=0;i<idArray.length;i++) {
- console.info('activated os account id: ' + idArray[i]);
- }
- });
- } catch (e) {
- console.log('getActivatedOsAccountLocalIds exception:' + JSON.stringify(e));
- }
getActivatedOsAccountLocalIds(): Promise<Array<number>>
查詢當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號(hào)的ID列表。使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<Array<number>> | Promise對(duì)象,返回當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號(hào)的ID列表。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getActivatedOsAccountLocalIds().then((idArray) => {
- console.log('getActivatedOsAccountLocalIds, idArray: ' + idArray);
- }).catch((err) => {
- console.log('getActivatedOsAccountLocalIds err: ' + JSON.stringify(err));
- });
- } catch (e) {
- console.log('getActivatedOsAccountLocalIds exception:' + JSON.stringify(e));
- }
getCurrentOsAccount(callback: AsyncCallback<OsAccountInfo>): void
查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的信息。使用callback異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<OsAccountInfo> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)信息;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getCurrentOsAccount((err, curAccountInfo)=>{
- console.log('getCurrentOsAccount err:' + JSON.stringify(err));
- console.log('getCurrentOsAccount curAccountInfo:' + JSON.stringify(curAccountInfo));
- });
- } catch (e) {
- console.log('getCurrentOsAccount exception:' + JSON.stringify(e));
- }
getCurrentOsAccount(): Promise<OsAccountInfo>
查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的信息。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<OsAccountInfo> | Promise對(duì)象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)信息。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getCurrentOsAccount().then((accountInfo) => {
- console.log('getCurrentOsAccount, accountInfo: ' + JSON.stringify(accountInfo));
- }).catch((err) => {
- console.log('getCurrentOsAccount err: ' + JSON.stringify(err));
- });
- } catch (e) {
- console.log('getCurrentOsAccount exception:' + JSON.stringify(e));
- }
getOsAccountType(callback: AsyncCallback<OsAccountType>): void
查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的帳號(hào)類型。使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<OsAccountType> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的帳號(hào)類型;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getOsAccountType((err, accountType) => {
- console.log('getOsAccountType err: ' + JSON.stringify(err));
- console.log('getOsAccountType accountType: ' + accountType);
- });
- } catch (e) {
- console.log('getOsAccountType exception: ' + JSON.stringify(e));
- }
getOsAccountType(): Promise<OsAccountType>
查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的帳號(hào)類型。使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<OsAccountType> | Promise對(duì)象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的帳號(hào)類型。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.getOsAccountType().then((accountType) => {
- console.log('getOsAccountType, accountType: ' + accountType);
- }).catch((err) => {
- console.log('getOsAccountType err: ' + JSON.stringify(err));
- });
- } catch (e) {
- console.log('getOsAccountType exception: ' + JSON.stringify(e));
- }
queryDistributedVirtualDeviceId(callback: AsyncCallback<string>): void
獲取分布式虛擬設(shè)備ID。使用callback異步回調(diào)。
需要權(quán)限: ohos.permission.DISTRIBUTED_DATASYNC or ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<string> | 是 | 回調(diào)函數(shù)。如果獲取成功,err為null,data為分布式虛擬設(shè)備ID;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.queryDistributedVirtualDeviceId((err, virtualID) => {
- console.log('queryDistributedVirtualDeviceId err: ' + JSON.stringify(err));
- console.log('queryDistributedVirtualDeviceId virtualID: ' + virtualID);
- });
- } catch (e) {
- console.log('queryDistributedVirtualDeviceId exception: ' + JSON.stringify(e));
- }
queryDistributedVirtualDeviceId(): Promise<string>
獲取分布式虛擬設(shè)備ID。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.DISTRIBUTED_DATASYNC or ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<string> | Promise對(duì)象,返回分布式虛擬設(shè)備ID。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | System service exception. |
示例:
- let accountManager = account_osAccount.getAccountManager();
- try {
- accountManager.queryDistributedVirtualDeviceId().then((virtualID) => {
- console.log('queryDistributedVirtualDeviceId, virtualID: ' + virtualID);
- }).catch((err) => {
- console.log('queryDistributedVirtualDeviceId err: ' + JSON.stringify(err));
- });
- } catch (e) {
- console.log('queryDistributedVirtualDeviceId exception: ' + JSON.stringify(e));
- }
getOsAccountLocalIdForSerialNumber(serialNumber: number, callback: AsyncCallback<number>): void
通過SN碼查詢與其關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
serialNumber | number | 是 | 帳號(hào)SN碼。 |
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。如果成功,err為null,data為與SN碼關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid serialNumber. |
12300003 | the account indicated by serialNumber dose not exist. |
示例: 查詢與SN碼12345關(guān)聯(lián)的系統(tǒng)帳號(hào)的ID
- let accountManager = account_osAccount.getAccountManager();
- let serialNumber = 12345;
- try {
- accountManager.getOsAccountLocalIdForSerialNumber(serialNumber, (err, localId)=>{
- console.log('ger localId err:' + JSON.stringify(err));
- console.log('get localId:' + localId + ' by serialNumber: ' + serialNumber);
- });
- } catch (e) {
- console.log('ger localId exception:' + JSON.stringify(e));
- }
getOsAccountLocalIdForSerialNumber(serialNumber: number): Promise<number>
通過SN碼查詢與其關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
serialNumber | number | 是 | 帳號(hào)SN碼。 |
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回與SN碼關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid serialNumber. |
12300003 | the account indicated by serialNumber dose not exist. |
示例: 查詢與SN碼12345關(guān)聯(lián)的系統(tǒng)帳號(hào)的ID
- let accountManager = account_osAccount.getAccountManager();
- let serialNumber = 12345;
- try {
- accountManager.getOsAccountLocalIdForSerialNumber(serialNumber).then((localId) => {
- console.log('getOsAccountLocalIdForSerialNumber localId: ' + localId);
- }).catch((err) => {
- console.log('getOsAccountLocalIdForSerialNumber err: ' + JSON.stringify(err));
- });
- } catch (e) {
- console.log('getOsAccountLocalIdForSerialNumber exception: ' + JSON.stringify(e));
- }
getSerialNumberForOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void
通過系統(tǒng)帳號(hào)ID獲取與該系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼。使用callback異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。如果獲取成功,err為null,data為與該系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼;否則為錯(cuò)誤對(duì)象。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid localId. |
12300003 | the account indicated by localId dose not exist. |
示例: 獲取ID為100的系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- try {
- accountManager.getSerialNumberForOsAccountLocalId(localId, (err, serialNumber)=>{
- console.log('ger serialNumber err:' + JSON.stringify(err));
- console.log('get serialNumber:' + serialNumber + ' by localId: ' + localId);
- });
- } catch (e) {
- console.log('ger serialNumber exception:' + JSON.stringify(e));
- }
getSerialNumberForOsAccountLocalId(localId: number): Promise<number>
通過系統(tǒng)帳號(hào)ID獲取與該系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼。使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回與該系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼。 |
錯(cuò)誤碼:
錯(cuò)誤碼ID | 錯(cuò)誤信息 |
---|---|
12300001 | system service exception. |
12300002 | invalid localId. |
12300003 | the account indicated by localId dose not exist. |
示例: 獲取ID為100的系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- try {
- accountManager.getSerialNumberForOsAccountLocalId(localId).then((serialNumber) => {
- console.log('getSerialNumberForOsAccountLocalId serialNumber: ' + serialNumber);
- }).catch((err) => {
- console.log('getSerialNumberForOsAccountLocalId err: ' + JSON.stringify(err));
- });
- } catch (e) {
- console.log('getSerialNumberForOsAccountLocalId exception:' + JSON.stringify(e));
- }
isMultiOsAccountEnable(callback: AsyncCallback<boolean>): void
判斷是否支持多系統(tǒng)帳號(hào)。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkMultiOsAccountEnabled。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示支持多系統(tǒng)帳號(hào);返回false表示不支持。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.isMultiOsAccountEnable((err, isEnabled) => {
- if (err) {
- console.log("isMultiOsAccountEnable failed, error: " + JSON.stringify(err));
- } else {
- console.log("isMultiOsAccountEnable successfully, isEnabled: " + isEnabled);
- }
- });
isMultiOsAccountEnable(): Promise<boolean>
判斷是否支持多系統(tǒng)帳號(hào)。使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkMultiOsAccountEnabled。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示支持多系統(tǒng)帳號(hào);返回false表示不支持。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.isMultiOsAccountEnable().then((isEnabled) => {
- console.log('isMultiOsAccountEnable successfully, isEnabled: ' + isEnabled);
- }).catch((err) => {
- console.log('isMultiOsAccountEnable failed, error: ' + JSON.stringify(err));
- });
isOsAccountActived(localId: number, callback: AsyncCallback<boolean>): void
判斷指定系統(tǒng)帳號(hào)是否處于激活狀態(tài)。使用callback異步回調(diào)。
從 API version 7開始支持從API version 9開始廢棄, 建議使用checkOsAccountActivated。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示帳號(hào)已激活;返回false表示帳號(hào)未激活。 |
示例: 判斷ID為100的系統(tǒng)帳號(hào)是否處于激活狀態(tài)
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- accountManager.isOsAccountActived(localId, (err, isActived) => {
- if (err) {
- console.log('isOsAccountActived failed, err:' + JSON.stringify(err));
- } else {
- console.log('isOsAccountActived successfully, isActived:' + isActived);
- }
- });
isOsAccountActived(localId: number): Promise<boolean>
判斷指定系統(tǒng)帳號(hào)是否處于激活狀態(tài)。使用Promise異步回調(diào)。
從 API version 7開始支持從API version 9開始廢棄, 建議使用checkOsAccountActivated。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示帳號(hào)已激活;返回false表示帳號(hào)未激活。 |
示例: 判斷ID為100的系統(tǒng)帳號(hào)是否處于激活狀態(tài)
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- accountManager.isOsAccountActived(localId).then((isActived) => {
- console.log('isOsAccountActived successfully, isActived: ' + isActived);
- }).catch((err) => {
- console.log('isOsAccountActived failed, error: ' + JSON.stringify(err));
- });
isOsAccountConstraintEnable(localId: number, constraint: string, callback: AsyncCallback<boolean>): void
判斷指定系統(tǒng)帳號(hào)是否具有指定約束。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkOsAccountConstraintEnabled。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
constraint | string | 是 | 指定的約束名稱。 |
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示已使能指定的約束;返回false表示未使能指定的約束。 |
示例: 判斷ID為100的系統(tǒng)帳號(hào)是否有禁止使用Wi-Fi的約束
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- let constraint = "constraint.wifi";
- accountManager.isOsAccountConstraintEnable(localId, constraint, (err, isEnabled) => {
- if (err) {
- console.log("isOsAccountConstraintEnable failed, error:" + JSON.stringify(err));
- } else {
- console.log("isOsAccountConstraintEnable successfully, isEnabled:" + isEnabled);
- }
- });
isOsAccountConstraintEnable(localId: number, constraint: string): Promise<boolean>
判斷指定系統(tǒng)帳號(hào)是否具有指定約束。使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkOsAccountConstraintEnabled。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
constraint | string | 是 | 指定的約束名稱。 |
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示已使能指定的約束;返回false表示未使能指定的約束。 |
示例: 判斷ID為100的系統(tǒng)帳號(hào)是否有禁止使用Wi-Fi的約束
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- let constraint = "constraint.wifi";
- accountManager.isOsAccountConstraintEnable(localId, constraint).then((isEnabled) => {
- console.log("isOsAccountConstraintEnable successfully, isEnabled: " + isEnabled);
- }).catch((err) => {
- console.log("isOsAccountConstraintEnable err: " + JSON.stringify(err));
- });
isTestOsAccount(callback: AsyncCallback<boolean>): void
檢查當(dāng)前系統(tǒng)帳號(hào)是否為測試帳號(hào)。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkOsAccountTestable。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示當(dāng)前帳號(hào)為測試帳號(hào);返回false表示當(dāng)前帳號(hào)非測試帳號(hào)。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.isTestOsAccount((err, isTestable) => {
- if (err) {
- console.log("isTestOsAccount failed, error: " + JSON.stringify(err));
- } else {
- console.log("isTestOsAccount successfully, isTestable: " + isTestable);
- }
- });
isTestOsAccount(): Promise<boolean>
檢查當(dāng)前系統(tǒng)帳號(hào)是否為測試帳號(hào)。使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkOsAccountTestable。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示當(dāng)前帳號(hào)為測試帳號(hào);返回false表示當(dāng)前帳號(hào)非測試帳號(hào)。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.isTestOsAccount().then((isTestable) => {
- console.log("isTestOsAccount successfully, isTestable: " + isTestable);
- }).catch((err) => {
- console.log("isTestOsAccount failed, error: " + JSON.stringify(err));
- });
isOsAccountVerified(callback: AsyncCallback<boolean>): void
檢查當(dāng)前系統(tǒng)帳號(hào)是否已驗(yàn)證。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkOsAccountVerified。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示指定帳號(hào)已驗(yàn)證;返回false表示指定帳號(hào)未驗(yàn)證。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.isOsAccountVerified((err, isVerified) => {
- if (err) {
- console.log("isOsAccountVerified failed, error: " + JSON.stringify(err));
- } else {
- console.log("isOsAccountVerified successfully, isVerified: " + isVerified);
- }
- });
isOsAccountVerified(localId: number, callback: AsyncCallback<boolean>): void
檢查指定系統(tǒng)帳號(hào)是否已驗(yàn)證。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkOsAccountVerified。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
callback | AsyncCallback<boolean> | 是 | 回調(diào)函數(shù)。返回true表示指定帳號(hào)已驗(yàn)證;返回false表示指定帳號(hào)未驗(yàn)證。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- accountManager.isOsAccountVerified(localId, (err, isVerified) => {
- if (err) {
- console.log("isOsAccountVerified failed, error: " + JSON.stringify(err));
- } else {
- console.log("isOsAccountVerified successfully, isVerified: " + isVerified);
- }
- });
isOsAccountVerified(localId?: number): Promise<boolean>
檢查指定系統(tǒng)帳號(hào)是否已驗(yàn)證。使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用checkOsAccountVerified。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 否 | 系統(tǒng)帳號(hào)ID。不填則檢查當(dāng)前系統(tǒng)帳號(hào)是否已驗(yàn)證。 |
返回值:
類型 | 說明 |
---|---|
Promise<boolean> | Promise對(duì)象。返回true表示指定帳號(hào)已驗(yàn)證;返回false表示指定帳號(hào)未驗(yàn)證。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.isOsAccountVerified(localId).then((isVerified) => {
- console.log("isOsAccountVerified successfully, isVerified: " + isVerified);
- }).catch((err) => {
- console.log("isOsAccountVerified failed, error: " + JSON.stringify(err));
- });
getCreatedOsAccountsCount(callback: AsyncCallback<number>): void
獲取已創(chuàng)建的系統(tǒng)帳號(hào)數(shù)量。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountCount。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。當(dāng)獲取成功時(shí),err為null,data為已創(chuàng)建的系統(tǒng)帳號(hào)的數(shù)量;否則為錯(cuò)誤對(duì)象。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getCreatedOsAccountsCount((err, count)=>{
- if (err) {
- console.log("getCreatedOsAccountsCount failed, error: " + JSON.stringify(err));
- } else {
- console.log("getCreatedOsAccountsCount successfully, count: " + count);
- }
- });
getCreatedOsAccountsCount(): Promise<number>
獲取已創(chuàng)建的系統(tǒng)帳號(hào)數(shù)量,使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountCount。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回已創(chuàng)建的系統(tǒng)帳號(hào)的數(shù)量。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getCreatedOsAccountsCount().then((count) => {
- console.log("getCreatedOsAccountsCount successfully, count: " + count);
- }).catch((err) => {
- console.log("getCreatedOsAccountsCount failed, error: " + JSON.stringify(err));
- });
getOsAccountLocalIdFromProcess(callback: AsyncCallback<number>): void
獲取當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)ID,使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalId。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。當(dāng)獲取成功時(shí),err為null,data為當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)ID;否則為錯(cuò)誤對(duì)象。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getOsAccountLocalIdFromProcess((err, localId) => {
- if (err) {
- console.log("getOsAccountLocalIdFromProcess failed, error: " + JSON.stringify(err));
- } else {
- console.log("getOsAccountLocalIdFromProcess successfully, localId: " + localId);
- }
- });
getOsAccountLocalIdFromProcess(): Promise<number>
獲取當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)ID,使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalId。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)ID。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getOsAccountLocalIdFromProcess().then((localId) => {
- console.log('getOsAccountLocalIdFromProcess successfully, localId: ' + localId);
- }).catch((err) => {
- console.log('getOsAccountLocalIdFromProcess failed, error: ' + JSON.stringify(err));
- });
getOsAccountLocalIdFromUid(uid: number, callback: AsyncCallback<number>): void
根據(jù)uid查詢對(duì)應(yīng)的系統(tǒng)帳號(hào)ID。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalIdForUid。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
uid | number | 是 | 進(jìn)程uid。 |
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為對(duì)應(yīng)的系統(tǒng)帳號(hào)ID;否則為錯(cuò)誤對(duì)象。 |
示例: 查詢值為12345678的uid所屬的系統(tǒng)帳號(hào)ID
- let accountManager = account_osAccount.getAccountManager();
- let uid = 12345678;
- accountManager.getOsAccountLocalIdFromUid(uid, (err, localId) => {
- if (err) {
- console.log("getOsAccountLocalIdFromUid failed, error: " + JSON.stringify(err));
- } else {
- console.log("getOsAccountLocalIdFromUid successfully, localId: " + localId);
- }
- });
getOsAccountLocalIdFromUid(uid: number): Promise<number>
根據(jù)uid查詢對(duì)應(yīng)的系統(tǒng)帳號(hào)ID,使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalIdForUid。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
uid | number | 是 | 進(jìn)程uid。 |
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回uid對(duì)應(yīng)的系統(tǒng)帳號(hào)ID。 |
示例: 查詢值為12345678的uid所屬的系統(tǒng)帳號(hào)ID
- let accountManager = account_osAccount.getAccountManager();
- let uid = 12345678;
- accountManager.getOsAccountLocalIdFromUid(uid).then((localId) => {
- console.log("getOsAccountLocalIdFromUid successfully, localId: " + localId);
- }).catch((err) => {
- console.log("getOsAccountLocalIdFromUid failed, error: " + JSON.stringify(err));
- });
getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void
根據(jù)域帳號(hào)信息,獲取與其關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。使用callback異步回調(diào)。
從 API version 8開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalIdForDomain。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
domainInfo | 是 | 域帳號(hào)信息。 | |
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù),如果獲取成功,err為null,data為域帳號(hào)關(guān)聯(lián)的系統(tǒng)帳號(hào)ID;否則為錯(cuò)誤對(duì)象。 |
示例:
- let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getOsAccountLocalIdFromDomain(domainInfo, (err, localId) => {
- if (err) {
- console.log("getOsAccountLocalIdFromDomain failed, error: " + JSON.stringify(err));
- } else {
- console.log("getOsAccountLocalIdFromDomain successfully, localId: " + localId);
- }
- });
getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise<number>
根據(jù)域帳號(hào)信息,獲取與其關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。使用Promise異步回調(diào)。
從 API version 8開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalIdForDomain。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
domainInfo | 是 | 域帳號(hào)信息。 |
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回域帳號(hào)關(guān)聯(lián)的系統(tǒng)帳號(hào)ID。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
- accountManager.getOsAccountLocalIdFromDomain(domainInfo).then((localId) => {
- console.log('getOsAccountLocalIdFromDomain successfully, localId: ' + localId);
- }).catch((err) => {
- console.log('getOsAccountLocalIdFromDomain failed, error: ' + JSON.stringify(err));
- });
getOsAccountAllConstraints(localId: number, callback: AsyncCallback<Array<string>>): void
獲取指定系統(tǒng)帳號(hào)的全部約束。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountConstraints。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
callback | AsyncCallback<Array<string>> | 是 | 回調(diào)函數(shù)。如果獲取成功,err為null,data為指定系統(tǒng)帳號(hào)的全部約束;否則為錯(cuò)誤對(duì)象。 |
示例: 獲取ID為100的系統(tǒng)帳號(hào)的全部約束
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- accountManager.getOsAccountAllConstraints(localId, (err, constraints)=>{
- console.log('getOsAccountAllConstraints err:' + JSON.stringify(err));
- console.log('getOsAccountAllConstraints:' + JSON.stringify(constraints));
- });
getOsAccountAllConstraints(localId: number): Promise<Array<string>>
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountConstraints。
獲取指定系統(tǒng)帳號(hào)的全部約束。使用Promise異步回調(diào)。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
返回值:
類型 | 說明 |
---|---|
Promise<Array<string>> | Promise對(duì)象,返回指定系統(tǒng)帳號(hào)的全部約束。 |
示例: 獲取ID為100的系統(tǒng)帳號(hào)的全部約束
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- accountManager.getOsAccountAllConstraints(localId).then((constraints) => {
- console.log('getOsAccountAllConstraints, constraints: ' + constraints);
- }).catch((err) => {
- console.log('getOsAccountAllConstraints err: ' + JSON.stringify(err));
- });
queryActivatedOsAccountIds(callback: AsyncCallback<Array<number>>): void
查詢當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號(hào)的ID列表。使用callback異步回調(diào)。
從 API version 8開始支持,從API version 9開始廢棄。建議使用getActivatedOsAccountLocalIds。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<Array<number>> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號(hào)的ID列表;否則為錯(cuò)誤對(duì)象。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.queryActivatedOsAccountIds((err, idArray)=>{
- console.log('queryActivatedOsAccountIds err:' + JSON.stringify(err));
- console.log('queryActivatedOsAccountIds idArray length:' + idArray.length);
- for(let i=0;i<idArray.length;i++) {
- console.info('activated os account id: ' + idArray[i]);
- }
- });
queryActivatedOsAccountIds(): Promise<Array<number>>
從 API version 8開始支持,從API version 9開始廢棄。建議使用getActivatedOsAccountLocalIds。
查詢當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號(hào)的ID列表。使用Promise異步回調(diào)。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<Array<number>> | Promise對(duì)象,返回當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號(hào)的ID列表。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.queryActivatedOsAccountIds().then((idArray) => {
- console.log('queryActivatedOsAccountIds, idArray: ' + idArray);
- }).catch((err) => {
- console.log('queryActivatedOsAccountIds err: ' + JSON.stringify(err));
- });
queryCurrentOsAccount(callback: AsyncCallback<OsAccountInfo>): void
查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的信息。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getCurrentOsAccount。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<OsAccountInfo> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)信息;否則為錯(cuò)誤對(duì)象。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.queryCurrentOsAccount((err, curAccountInfo)=>{
- console.log('queryCurrentOsAccount err:' + JSON.stringify(err));
- console.log('queryCurrentOsAccount curAccountInfo:' + JSON.stringify(curAccountInfo));
- });
queryCurrentOsAccount(): Promise<OsAccountInfo>
查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的信息。使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getCurrentOsAccount。
需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<OsAccountInfo> | Promise對(duì)象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)信息。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.queryCurrentOsAccount().then((accountInfo) => {
- console.log('queryCurrentOsAccount, accountInfo: ' + JSON.stringify(accountInfo));
- }).catch((err) => {
- console.log('queryCurrentOsAccount err: ' + JSON.stringify(err));
- });
getOsAccountTypeFromProcess(callback: AsyncCallback<OsAccountType>): void
查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的帳號(hào)類型。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountType。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<OsAccountType> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的帳號(hào)類型;否則為錯(cuò)誤對(duì)象。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getOsAccountTypeFromProcess((err, accountType) => {
- console.log('getOsAccountTypeFromProcess err: ' + JSON.stringify(err));
- console.log('getOsAccountTypeFromProcess accountType: ' + accountType);
- });
getOsAccountTypeFromProcess(): Promise<OsAccountType>
查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的帳號(hào)類型。使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountType。
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<OsAccountType> | Promise對(duì)象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號(hào)的帳號(hào)類型。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getOsAccountTypeFromProcess().then((accountType) => {
- console.log('getOsAccountTypeFromProcess, accountType: ' + accountType);
- }).catch((err) => {
- console.log('getOsAccountTypeFromProcess err: ' + JSON.stringify(err));
- });
getDistributedVirtualDeviceId(callback: AsyncCallback<string>): void
獲取分布式虛擬設(shè)備ID。使用callback異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用queryDistributedVirtualDeviceId。
需要權(quán)限: ohos.permission.DISTRIBUTED_DATASYNC 或 ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
callback | AsyncCallback<string> | 是 | 回調(diào)函數(shù)。如果獲取成功,err為null,data為分布式虛擬設(shè)備ID;否則為錯(cuò)誤對(duì)象。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getDistributedVirtualDeviceId((err, virtualID) => {
- console.log('getDistributedVirtualDeviceId err: ' + JSON.stringify(err));
- console.log('getDistributedVirtualDeviceId virtualID: ' + virtualID);
- });
getDistributedVirtualDeviceId(): Promise<string>
獲取分布式虛擬設(shè)備ID。使用Promise異步回調(diào)。
從 API version 7開始支持,從API version 9開始廢棄。建議使用queryDistributedVirtualDeviceId。
需要權(quán)限: ohos.permission.DISTRIBUTED_DATASYNC 或 ohos.permission.MANAGE_LOCAL_ACCOUNTS
系統(tǒng)能力: SystemCapability.Account.OsAccount
返回值:
類型 | 說明 |
---|---|
Promise<string> | Promise對(duì)象,返回分布式虛擬設(shè)備ID。 |
示例:
- let accountManager = account_osAccount.getAccountManager();
- accountManager.getDistributedVirtualDeviceId().then((virtualID) => {
- console.log('getDistributedVirtualDeviceId, virtualID: ' + virtualID);
- }).catch((err) => {
- console.log('getDistributedVirtualDeviceId err: ' + JSON.stringify(err));
- });
getOsAccountLocalIdBySerialNumber(serialNumber: number, callback: AsyncCallback<number>): void
通過SN碼查詢與其關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。使用callback異步回調(diào)。
從 API version 8開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalIdForSerialNumber。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
serialNumber | number | 是 | 帳號(hào)SN碼。 |
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。如果查詢成功,err為null,data為與SN碼關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID;否則為錯(cuò)誤對(duì)象。 |
示例: 查詢與SN碼12345關(guān)聯(lián)的系統(tǒng)帳號(hào)的ID
- let accountManager = account_osAccount.getAccountManager();
- let serialNumber = 12345;
- accountManager.getOsAccountLocalIdBySerialNumber(serialNumber, (err, localId)=>{
- console.log('ger localId err:' + JSON.stringify(err));
- console.log('get localId:' + localId + ' by serialNumber: ' + serialNumber);
- });
getOsAccountLocalIdBySerialNumber(serialNumber: number): Promise<number>
通過SN碼查詢與其關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。使用Promise異步回調(diào)。
從 API version 8開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalIdForSerialNumber。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
serialNumber | number | 是 | 帳號(hào)SN碼。 |
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回與SN碼關(guān)聯(lián)的系統(tǒng)帳號(hào)的帳號(hào)ID。 |
示例: 查詢與SN碼12345關(guān)聯(lián)的系統(tǒng)帳號(hào)的ID
- let accountManager = account_osAccount.getAccountManager();
- let serialNumber = 12345;
- accountManager.getOsAccountLocalIdBySerialNumber(serialNumber).then((localId) => {
- console.log('getOsAccountLocalIdBySerialNumber localId: ' + localId);
- }).catch((err) => {
- console.log('getOsAccountLocalIdBySerialNumber err: ' + JSON.stringify(err));
- });
getSerialNumberByOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void
通過系統(tǒng)帳號(hào)ID獲取與該系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼。使用callback異步回調(diào)。
從 API version 8開始支持,從API version 9開始廢棄。建議使用getSerialNumberForOsAccountLocalId。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
callback | AsyncCallback<number> | 是 | 回調(diào)函數(shù)。如果獲取成功,err為null,data為與該系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼;否則為錯(cuò)誤對(duì)象。 |
示例: 獲取ID為100的系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- accountManager.getSerialNumberByOsAccountLocalId(localId, (err, serialNumber)=>{
- console.log('ger serialNumber err:' + JSON.stringify(err));
- console.log('get serialNumber:' + serialNumber + ' by localId: ' + localId);
- });
getSerialNumberByOsAccountLocalId(localId: number): Promise<number>
通過系統(tǒng)帳號(hào)ID獲取與該系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼。使用Promise異步回調(diào)。
從 API version 8開始支持,從API version 9開始廢棄。建議使用getSerialNumberForOsAccountLocalId。
系統(tǒng)能力: SystemCapability.Account.OsAccount
參數(shù):
參數(shù)名 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
返回值:
類型 | 說明 |
---|---|
Promise<number> | Promise對(duì)象,返回與該系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼。 |
示例: 獲取ID為100的系統(tǒng)帳號(hào)關(guān)聯(lián)的SN碼
- let accountManager = account_osAccount.getAccountManager();
- let localId = 100;
- accountManager.getSerialNumberByOsAccountLocalId(localId).then((serialNumber) => {
- console.log('getSerialNumberByOsAccountLocalId serialNumber: ' + serialNumber);
- }).catch((err) => {
- console.log('getSerialNumberByOsAccountLocalId err: ' + JSON.stringify(err));
- });
表示系統(tǒng)帳號(hào)信息。
系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Account.OsAccount。
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
localId | number | 是 | 系統(tǒng)帳號(hào)ID。 |
localName | string | 是 | 系統(tǒng)帳號(hào)名稱。 |
type | 是 | 系統(tǒng)帳號(hào)類型 | |
constraints | Array<string> | 否 | 系統(tǒng)帳號(hào)約束 |
isVerified8+ | boolean | 是 | 帳號(hào)是否驗(yàn)證 |
photo8+ | string | 否 | 系統(tǒng)帳號(hào)頭像 |
createTime8+ | number | 是 | 系統(tǒng)帳號(hào)創(chuàng)建時(shí)間 |
lastLoginTime8+ | number | 否 | 系統(tǒng)帳號(hào)最后一次登錄時(shí)間 |
serialNumber8+ | number | 是 | 系統(tǒng)帳號(hào)SN碼 |
isActived8+ | boolean | 是 | 系統(tǒng)帳號(hào)激活狀態(tài) |
isCreateCompleted8+ | boolean | 是 | 系統(tǒng)帳號(hào)創(chuàng)建是否完整 |
distributedInfo | 否 | 分布式帳號(hào)信息 | |
domainInfo8+ | 否 | 域帳號(hào)信息 |
表示域帳號(hào)信息。
系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Account.OsAccount。
名稱 | 類型 | 必填 | 說明 |
---|---|---|---|
domain | string | 是 | 域名。 |
accountName | string | 是 | 域帳號(hào)名。 |
約束 | 說明 |
---|---|
constraint.wifi | 禁止使用Wi-Fi |
constraint.wifi.set | 禁止配置Wi-Fi |
constraint.locale.set | 禁止配置設(shè)備語言 |
constraint.app.accounts | 禁止添加和刪除應(yīng)用帳號(hào) |
constraint.apps.install | 禁止安裝應(yīng)用 |
constraint.apps.uninstall | 禁止卸載應(yīng)用 |
constraint.location.shared | 禁止打開位置共享 |
constraint.unknown.sources.install | 禁止安裝未知來源的應(yīng)用 |
constraint.global.unknown.app.install | 禁止所有用戶安裝未知來源的應(yīng)用 |
constraint.bluetooth.set | 禁止配置藍(lán)牙 |
constraint.bluetooth | 禁止使用藍(lán)牙 |
constraint.bluetooth.share | 禁止共享使用藍(lán)牙 |
constraint.usb.file.transfer | 禁止通過USB傳輸文件 |
constraint.credentials.set | 禁止配置用戶憑據(jù) |
constraint.os.account.remove | 禁止刪除用戶 |
constraint.managed.profile.remove | 禁止刪除此用戶的托管配置文件 |
constraint.debug.features.use | J禁止啟用或訪問調(diào)試功能 |
constraint.vpn.set | 禁止配置VPN |
constraint.date.time.set | 禁止配置日期時(shí)間和時(shí)區(qū) |
constraint.tethering.config | 禁止配置Tethering |
constraint.network.reset | 禁止重置網(wǎng)絡(luò)設(shè)置 |
constraint.factory.reset | 禁止出廠設(shè)置 |
constraint.os.account.create | 禁止創(chuàng)建新用戶 |
constraint.add.managed.profile | 禁止添加托管配置文件 |
constraint.apps.verify.disable | 強(qiáng)制應(yīng)用程序驗(yàn)證 |
constraint.cell.broadcasts.set | 禁止配置小區(qū)廣播 |
constraint.mobile.networks.set | 禁止配置移動(dòng)網(wǎng)絡(luò) |
constraint.control.apps | 禁止在設(shè)置或啟動(dòng)模塊中修改應(yīng)用程序 |
constraint.physical.media | 禁止裝載物理外部介質(zhì) |
constraint.microphone | 禁止使用麥克風(fēng) |
constraint.microphone.unmute | 禁止取消麥克風(fēng)靜音 |
constraint.volume.adjust | 禁止調(diào)整音量 |
constraint.calls.outgoing | 禁止撥打外呼電話 |
constraint.sms.use | 禁止發(fā)送或接收短信 |
constraint.fun | 禁止享受樂趣 |
constraint.windows.create | 禁止創(chuàng)建應(yīng)用程序窗口以外的窗口 |
constraint.system.error.dialogs | 禁止顯示崩潰或無響應(yīng)應(yīng)用程序的系統(tǒng)錯(cuò)誤對(duì)話框 |
constraint.cross.profile.copy.paste | 禁止通過將數(shù)據(jù)粘貼到其他用戶或配置文件來導(dǎo)出剪貼板內(nèi)容 |
constraint.beam.outgoing | 禁止使用NFC從應(yīng)用程序傳送數(shù)據(jù) |
constraint.wallpaper | 禁止管理壁紙 |
constraint.safe.boot | 禁止進(jìn)入安全引導(dǎo)模式 |
constraint.parent.profile.app.linking | 允許父配置文件中的應(yīng)用程序處理來自托管配置文件的Web鏈接 |
constraint.audio.record | 禁止錄制音頻 |
constraint.camera.use | 禁止使用攝像機(jī) |
constraint.os.account.background.run | 禁止在后臺(tái)運(yùn)行 |
constraint.data.roam | 禁止漫游通話時(shí)使用蜂窩數(shù)據(jù) |
constraint.os.account.set.icon | 禁止修改用戶頭像 |
constraint.wallpaper.set | 禁止設(shè)置壁紙 |
constraint.oem.unlock | 禁止啟用oem解鎖 |
constraint.device.unmute | 禁止取消設(shè)備靜音 |
constraint.password.unified | 禁止托管配置文件與主用戶進(jìn)行統(tǒng)一鎖屏質(zhì)詢 |
constraint.autofill | 禁止使用自動(dòng)填充服務(wù) |
constraint.content.capture | 禁止捕獲用戶屏幕 |
constraint.content.suggestions | 禁止接收內(nèi)容建議 |
constraint.os.account.start | 禁止切換用戶 |
constraint.location.set | 禁止配置位置服務(wù) |
constraint.airplane.mode.set | 禁止飛行模式 |
constraint.brightness.set | 禁止配置亮度 |
constraint.share.into.profile | 禁止將主要用戶的文件/圖片/數(shù)據(jù)共享到托管配置文件中 |
constraint.ambient.display | 禁止顯示環(huán)境 |
constraint.screen.timeout.set | 禁止配置屏幕關(guān)閉的超時(shí) |
constraint.print | 禁止打印 |
constraint.private.dns.set | 禁止配置專用DNS |
更多建議: