系統(tǒng)帳號管理

2024-01-23 17:55 更新

本模塊提供管理系統(tǒng)帳號的基礎(chǔ)能力,包括系統(tǒng)帳號的添加、刪除、查詢、設(shè)置、訂閱、啟動等功能。

說明

本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口,采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

  1. import account_osAccount from '@ohos.account.osAccount';

account_osAccount.getAccountManager

getAccountManager(): AccountManager

獲取系統(tǒng)帳號管理對象。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

AccountManager

系統(tǒng)帳號管理對象。

示例:

  1. let accountManager = account_osAccount.getAccountManager();

OsAccountType

表示系統(tǒng)帳號類型的枚舉。

系統(tǒng)能力: SystemCapability.Account.OsAccount。

名稱

說明

ADMIN

0

管理員帳號。

NORMAL

1

普通帳號。

GUEST

2

訪客帳號。

AccountManager

系統(tǒng)帳號管理類。

checkMultiOsAccountEnabled9+

checkMultiOsAccountEnabled(callback: AsyncCallback<boolean>): void

判斷是否支持多系統(tǒng)帳號。使用callback異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示支持多系統(tǒng)帳號;返回false表示不支持。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.checkMultiOsAccountEnabled((err, isEnabled) => {
  4. if (err) {
  5. console.log("checkMultiOsAccountEnabled failed, error: " + JSON.stringify(err));
  6. } else {
  7. console.log("checkMultiOsAccountEnabled successfully, isEnabled: " + isEnabled);
  8. }
  9. });
  10. } catch (err) {
  11. console.log("checkMultiOsAccountEnabled exception: " + JSON.stringify(err));
  12. }

checkMultiOsAccountEnabled9+

checkMultiOsAccountEnabled(): Promise<boolean>

判斷是否支持多系統(tǒng)帳號。使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示支持多系統(tǒng)帳號;返回false表示不支持。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. try {
  2. let accountManager = account_osAccount.getAccountManager();
  3. accountManager.checkMultiOsAccountEnabled().then((isEnabled) => {
  4. console.log('checkMultiOsAccountEnabled successfully, isEnabled: ' + isEnabled);
  5. }).catch((err) => {
  6. console.log('checkMultiOsAccountEnabled failed, error: ' + JSON.stringify(err));
  7. });
  8. } catch (err) {
  9. console.log('checkMultiOsAccountEnabled exception: ' + JSON.stringify(err));
  10. }

checkOsAccountActivated9+

checkOsAccountActivated(localId: number, callback: AsyncCallback<boolean>): void

判斷指定系統(tǒng)帳號是否處于激活狀態(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)帳號ID。

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示帳號已激活;返回false表示帳號未激活。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

12300002

Invalid localId.

12300003

Account not found.

示例: 判斷ID為100的系統(tǒng)帳號是否處于激活狀態(tài)

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. try {
  4. accountManager.checkOsAccountActivated(localId, (err, isActivated) => {
  5. if (err) {
  6. console.log('checkOsAccountActivated failed, error:' + JSON.stringify(err));
  7. } else {
  8. console.log('checkOsAccountActivated successfully, isActivated:' + isActivated);
  9. }
  10. });
  11. } catch (err) {
  12. console.log('checkOsAccountActivated exception:' + JSON.stringify(err));
  13. }

checkOsAccountActivated9+

checkOsAccountActivated(localId: number): Promise<boolean>

判斷指定系統(tǒng)帳號是否處于激活狀態(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)帳號ID。

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示帳號已激活;返回false表示帳號未激活。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

12300002

Invalid localId.

12300003

Account not found.

示例: 判斷ID為100的系統(tǒng)帳號是否處于激活狀態(tài)

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. try {
  4. accountManager.checkOsAccountActivated(localId).then((isActivated) => {
  5. console.log('checkOsAccountActivated successfully, isActivated: ' + isActivated);
  6. }).catch((err) => {
  7. console.log('checkOsAccountActivated failed, error: ' + JSON.stringify(err));
  8. });
  9. } catch (err) {
  10. console.log('checkOsAccountActivated exception:' + JSON.stringify(err));
  11. }

checkOsAccountConstraintEnabled9+

checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void

判斷指定系統(tǒng)帳號是否具有指定約束。使用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)帳號ID。

constraint

string

指定的約束名稱。

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示已使能指定的約束;返回false表示未使能指定的約束。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid localId or constraint.

12300003

the account indicated by localId dose not exist.

示例: 判斷ID為100的系統(tǒng)帳號是否有禁止使用Wi-Fi的約束

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. let constraint = "constraint.wifi";
  4. try {
  5. accountManager.checkOsAccountConstraintEnabled(localId, constraint, (err, isEnabled)=>{
  6. if (err) {
  7. console.log("checkOsAccountConstraintEnabled failed, error: " + JSON.stringify(err));
  8. } else {
  9. console.log("checkOsAccountConstraintEnabled successfully, isEnabled: " + isEnabled);
  10. }
  11. });
  12. } catch (err) {
  13. console.log("checkOsAccountConstraintEnabled exception: " + JSON.stringify(err));
  14. }

checkOsAccountConstraintEnabled9+

checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>

判斷指定系統(tǒng)帳號是否具有指定約束。使用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)帳號ID。

constraint

string

指定的約束名稱。

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示已使能指定的約束;返回false表示未使能指定的約束。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid localId or constraint.

12300003

the account indicated by localId dose not exist.

示例: 判斷ID為100的系統(tǒng)帳號是否有禁止使用Wi-Fi的約束

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. let constraint = "constraint.wifi";
  4. try {
  5. accountManager.checkOsAccountConstraintEnabled(localId, constraint).then((isEnabled) => {
  6. console.log("checkOsAccountConstraintEnabled successfully, isEnabled: " + isEnabled);
  7. }).catch((err) => {
  8. console.log("checkOsAccountConstraintEnabled failed, error: " + JSON.stringify(err));
  9. });
  10. } catch (err) {
  11. console.log("checkOsAccountConstraintEnabled exception: " + JSON.stringify(err));
  12. }

checkOsAccountTestable9+

checkOsAccountTestable(callback: AsyncCallback<boolean>): void

檢查當(dāng)前系統(tǒng)帳號是否為測試帳號。使用callback異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示當(dāng)前帳號為測試帳號;返回false表示當(dāng)前帳號非測試帳號。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.checkOsAccountTestable((err, isTestable) => {
  4. if (err) {
  5. console.log("checkOsAccountTestable failed, error: " + JSON.stringify(err));
  6. } else {
  7. console.log("checkOsAccountTestable successfully, isTestable: " + isTestable);
  8. }
  9. });
  10. } catch (err) {
  11. console.log("checkOsAccountTestable error: " + JSON.stringify(err));
  12. }

checkOsAccountTestable9+

checkOsAccountTestable(): Promise<boolean>

檢查當(dāng)前系統(tǒng)帳號是否為測試帳號。使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示當(dāng)前帳號為測試帳號;返回false表示當(dāng)前帳號非測試帳號。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.checkOsAccountTestable().then((isTestable) => {
  4. console.log("checkOsAccountTestable successfully, isTestable: " + isTestable);
  5. }).catch((err) => {
  6. console.log("checkOsAccountTestable failed, error: " + JSON.stringify(err));
  7. });
  8. } catch (err) {
  9. console.log('checkOsAccountTestable exception: ' + JSON.stringify(err));
  10. }

checkOsAccountVerified9+

checkOsAccountVerified(callback: AsyncCallback<boolean>): void

檢查當(dāng)前系統(tǒng)帳號是否已驗證。使用callback異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示當(dāng)前帳號已驗證;返回false表示當(dāng)前帳號未驗證。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.checkOsAccountVerified((err, isVerified) => {
  4. if (err) {
  5. console.log("checkOsAccountVerified failed, error: " + JSON.stringify(err));
  6. } else {
  7. console.log("checkOsAccountVerified successfully, isVerified: " + isVerified);
  8. }
  9. });
  10. } catch (err) {
  11. console.log("checkOsAccountVerified exception: " + JSON.stringify(err));
  12. }

checkOsAccountVerified9+

checkOsAccountVerified(localId: number, callback: AsyncCallback<boolean>): void

檢查指定系統(tǒng)帳號是否已驗證。使用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)帳號ID。

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示指定帳號已驗證;返回false表示指定帳號未驗證。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid localId.

12300003

the account indicated by localId dose not exist.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. try {
  4. accountManager.checkOsAccountVerified(localId, (err, isVerified) => {
  5. if (err) {
  6. console.log("checkOsAccountVerified failed, error: " + JSON.stringify(err));
  7. } else {
  8. console.log("checkOsAccountVerified successfully, isVerified: " + isVerified);
  9. }
  10. });
  11. } catch (err) {
  12. console.log("checkOsAccountVerified exception: " + err);
  13. }

checkOsAccountVerified9+

checkOsAccountVerified(localId: number): Promise<boolean>

檢查指定系統(tǒng)帳號是否已驗證。使用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)帳號ID。

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示指定帳號已驗證;返回false表示指定帳號未驗證。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid localId.

12300003

the account indicated by localId dose not exist.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. try {
  4. accountManager.checkOsAccountVerified(localId).then((isVerified) => {
  5. console.log("checkOsAccountVerified successfully, isVerified: " + isVerified);
  6. }).catch((err) => {
  7. console.log("checkOsAccountVerified failed, error: " + JSON.stringify(err));
  8. });
  9. } catch (err) {
  10. console.log('checkOsAccountVerified exception: ' + JSON.stringify(err));
  11. }

getOsAccountCount9+

getOsAccountCount(callback: AsyncCallback<number>): void

獲取已創(chuàng)建的系統(tǒng)帳號數(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)獲取成功時,err為null,data為已創(chuàng)建的系統(tǒng)帳號的數(shù)量;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getOsAccountCount((err, count) => {
  4. if (err) {
  5. console.log("getOsAccountCount failed, error: " + JSON.stringify(err));
  6. } else {
  7. console.log("getOsAccountCount successfully, count: " + count);
  8. }
  9. });
  10. } catch (err) {
  11. console.log("getOsAccountCount exception: " + JSON.stringify(err));
  12. }

getOsAccountCount9+

getOsAccountCount(): Promise<number>

獲取已創(chuàng)建的系統(tǒng)帳號數(shù)量。使用Promise異步回調(diào)。

需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<number>

Promise對象,返回已創(chuàng)建的系統(tǒng)帳號的數(shù)量。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getOsAccountCount().then((count) => {
  4. console.log("getOsAccountCount successfully, count: " + count);
  5. }).catch((err) => {
  6. console.log("getOsAccountCount failed, error: " + JSON.stringify(err));
  7. });
  8. } catch(err) {
  9. console.log('getOsAccountCount exception:' + JSON.stringify(err));
  10. }

getOsAccountLocalId9+

getOsAccountLocalId(callback: AsyncCallback<number>): void

獲取當(dāng)前進(jìn)程所屬的系統(tǒng)帳號ID,使用callback異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

callback

AsyncCallback<number>

回調(diào)函數(shù)。當(dāng)獲取成功時,err為null,data為當(dāng)前進(jìn)程所屬的系統(tǒng)帳號ID;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getOsAccountLocalId((err, localId) => {
  4. if (err) {
  5. console.log("getOsAccountLocalId failed, error: " + JSON.stringify(err));
  6. } else {
  7. console.log("getOsAccountLocalId successfully, localId: " + localId);
  8. }
  9. });
  10. } catch (err) {
  11. console.log("getOsAccountLocalId exception: " + JSON.stringify(err));
  12. }

getOsAccountLocalId9+

getOsAccountLocalId(): Promise<number>

獲取當(dāng)前進(jìn)程所屬的系統(tǒng)帳號ID,使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<number>

Promise對象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號ID。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getOsAccountLocalId().then((localId) => {
  4. console.log("getOsAccountLocalId successfully, localId: " + localId);
  5. }).catch((err) => {
  6. console.log("getOsAccountLocalId failed, error: " + JSON.stringify(err));
  7. });
  8. } catch (err) {
  9. console.log('getOsAccountLocalId exception: ' + JSON.stringify(err));
  10. }

getOsAccountLocalIdForUid9+

getOsAccountLocalIdForUid(uid: number, callback: AsyncCallback<number>): void

根據(jù)uid查詢對應(yīng)的系統(tǒng)帳號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為對應(yīng)的系統(tǒng)帳號ID;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid uid.

示例: 查詢值為12345678的uid所屬的系統(tǒng)帳號的帳號ID

  1. let accountManager = account_osAccount.getAccountManager();
  2. let uid = 12345678;
  3. try {
  4. accountManager.getOsAccountLocalIdForUid(uid, (err, localId) => {
  5. if (err) {
  6. console.log("getOsAccountLocalIdForUid failed, error: " + JSON.stringify(err));
  7. }
  8. console.log("getOsAccountLocalIdForUid successfully, localId: " + localId);
  9. });
  10. } catch (err) {
  11. console.log("getOsAccountLocalIdForUid exception: " + JSON.stringify(err));
  12. }

getOsAccountLocalIdForUid9+

getOsAccountLocalIdForUid(uid: number): Promise<number>

根據(jù)uid查詢對應(yīng)的系統(tǒng)帳號ID,使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

uid

number

進(jìn)程uid。

返回值:

類型

說明

Promise<number>

Promise對象,返回指定uid對應(yīng)的系統(tǒng)帳號ID。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid uid.

示例: 查詢值為12345678的uid所屬的系統(tǒng)帳號ID

  1. let accountManager = account_osAccount.getAccountManager();
  2. let uid = 12345678;
  3. try {
  4. accountManager.getOsAccountLocalIdForUid(uid).then((localId) => {
  5. console.log("getOsAccountLocalIdForUid successfully, localId: " + localId);
  6. }).catch((err) => {
  7. console.log("getOsAccountLocalIdForUid failed, error: " + JSON.stringify(err));
  8. });
  9. } catch (err) {
  10. console.log('getOsAccountLocalIdForUid exception: ' + JSON.stringify(err));
  11. }

getOsAccountLocalIdForDomain9+

getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void

根據(jù)域帳號信息,獲取與其關(guān)聯(lián)的系統(tǒng)帳號ID。使用callback異步回調(diào)。

需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

domainInfo

DomainAccountInfo

域帳號信息。

callback

AsyncCallback<number>

回調(diào)函數(shù)。如果查詢成功,err為null,data為域帳號關(guān)聯(lián)的系統(tǒng)帳號ID;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid domainInfo.

示例:

  1. let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
  2. let accountManager = account_osAccount.getAccountManager();
  3. try {
  4. accountManager.getOsAccountLocalIdForDomain(domainInfo, (err, localId) => {
  5. if (err) {
  6. console.log("getOsAccountLocalIdForDomain failed, error: " + JSON.stringify(err));
  7. } else {
  8. console.log("getOsAccountLocalIdForDomain successfully, localId: " + localId);
  9. }
  10. });
  11. } catch (err) {
  12. console.log('getOsAccountLocalIdForDomain exception: ' + JSON.stringify(err));
  13. }

getOsAccountLocalIdForDomain9+

getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo): Promise<number>

根據(jù)域帳號信息,獲取與其關(guān)聯(lián)的系統(tǒng)帳號的帳號ID。使用Promise異步回調(diào)。

需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

domainInfo

DomainAccountInfo

域帳號信息。

返回值:

類型

說明

Promise<number>

Promise對象,返回域帳號關(guān)聯(lián)的系統(tǒng)帳號ID。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid domainInfo.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
  3. try {
  4. accountManager.getOsAccountLocalIdForDomain(domainInfo).then((localId) => {
  5. console.log("getOsAccountLocalIdForDomain successfully, localId: " + localId);
  6. }).catch((err) => {
  7. console.log("getOsAccountLocalIdForDomain failed, error: " + JSON.stringify(err));
  8. });
  9. } catch (err) {
  10. console.log("getOsAccountLocalIdForDomain exception: " + JSON.stringify(err));
  11. }

getOsAccountConstraints9+

getOsAccountConstraints(localId: number, callback: AsyncCallback<Array<string>>): void

獲取指定系統(tǒng)帳號的全部約束。使用callback異步回調(diào)。

需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

localId

number

系統(tǒng)帳號ID。

callback

AsyncCallback<Array<string>>

回調(diào)函數(shù),如果獲取成功,err為null,data為該系統(tǒng)帳號的全部約束;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

12300002

Invalid localId.

12300003

Account not found.

示例: 獲取ID為100的系統(tǒng)帳號的全部約束

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. try {
  4. accountManager.getOsAccountConstraints(localId, (err, constraints) => {
  5. if (err) {
  6. console.log("getOsAccountConstraints failed, err: " + JSON.stringify(err));
  7. } else {
  8. console.log("getOsAccountConstraints successfully, constraints: " + JSON.stringify(constraints));
  9. }
  10. });
  11. } catch (err) {
  12. console.log('getOsAccountConstraints exception:' + JSON.stringify(err));
  13. }

getOsAccountConstraints9+

getOsAccountConstraints(localId: number): Promise<Array<string>>

獲取指定系統(tǒng)帳號的全部約束。使用Promise異步回調(diào)。

需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

localId

number

系統(tǒng)帳號ID。

返回值:

類型

說明

Promise<Array<string>>

Promise對象,返回指定系統(tǒng)帳號的全部約束。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

12300002

Invalid localId.

12300003

Account not found.

示例: 獲取ID為100的系統(tǒng)帳號的全部約束

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. try {
  4. accountManager.getOsAccountConstraints(localId).then((constraints) => {
  5. console.log('getOsAccountConstraints, constraints: ' + constraints);
  6. }).catch((err) => {
  7. console.log('getOsAccountConstraints err: ' + JSON.stringify(err));
  8. });
  9. } catch (e) {
  10. console.log('getOsAccountConstraints exception:' + JSON.stringify(e));
  11. }

getActivatedOsAccountLocalIds9+

getActivatedOsAccountLocalIds(callback: AsyncCallback<Array<number>>): void

查詢當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號的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)帳號的ID列表;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getActivatedOsAccountLocalIds((err, idArray)=>{
  4. console.log('getActivatedOsAccountLocalIds err:' + JSON.stringify(err));
  5. console.log('getActivatedOsAccountLocalIds idArray length:' + idArray.length);
  6. for(let i=0;i<idArray.length;i++) {
  7. console.info('activated os account id: ' + idArray[i]);
  8. }
  9. });
  10. } catch (e) {
  11. console.log('getActivatedOsAccountLocalIds exception:' + JSON.stringify(e));
  12. }

getActivatedOsAccountLocalIds9+

getActivatedOsAccountLocalIds(): Promise<Array<number>>

查詢當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號的ID列表。使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<Array<number>>

Promise對象,返回當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號的ID列表。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getActivatedOsAccountLocalIds().then((idArray) => {
  4. console.log('getActivatedOsAccountLocalIds, idArray: ' + idArray);
  5. }).catch((err) => {
  6. console.log('getActivatedOsAccountLocalIds err: ' + JSON.stringify(err));
  7. });
  8. } catch (e) {
  9. console.log('getActivatedOsAccountLocalIds exception:' + JSON.stringify(e));
  10. }

getCurrentOsAccount9+

getCurrentOsAccount(callback: AsyncCallback<OsAccountInfo>): void

查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的信息。使用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)帳號信息;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getCurrentOsAccount((err, curAccountInfo)=>{
  4. console.log('getCurrentOsAccount err:' + JSON.stringify(err));
  5. console.log('getCurrentOsAccount curAccountInfo:' + JSON.stringify(curAccountInfo));
  6. });
  7. } catch (e) {
  8. console.log('getCurrentOsAccount exception:' + JSON.stringify(e));
  9. }

getCurrentOsAccount9+

getCurrentOsAccount(): Promise<OsAccountInfo>

查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的信息。使用Promise異步回調(diào)。

需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<OsAccountInfo>

Promise對象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號信息。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getCurrentOsAccount().then((accountInfo) => {
  4. console.log('getCurrentOsAccount, accountInfo: ' + JSON.stringify(accountInfo));
  5. }).catch((err) => {
  6. console.log('getCurrentOsAccount err: ' + JSON.stringify(err));
  7. });
  8. } catch (e) {
  9. console.log('getCurrentOsAccount exception:' + JSON.stringify(e));
  10. }

getOsAccountType9+

getOsAccountType(callback: AsyncCallback<OsAccountType>): void

查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的帳號類型。使用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)帳號的帳號類型;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getOsAccountType((err, accountType) => {
  4. console.log('getOsAccountType err: ' + JSON.stringify(err));
  5. console.log('getOsAccountType accountType: ' + accountType);
  6. });
  7. } catch (e) {
  8. console.log('getOsAccountType exception: ' + JSON.stringify(e));
  9. }

getOsAccountType9+

getOsAccountType(): Promise<OsAccountType>

查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的帳號類型。使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<OsAccountType>

Promise對象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的帳號類型。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.getOsAccountType().then((accountType) => {
  4. console.log('getOsAccountType, accountType: ' + accountType);
  5. }).catch((err) => {
  6. console.log('getOsAccountType err: ' + JSON.stringify(err));
  7. });
  8. } catch (e) {
  9. console.log('getOsAccountType exception: ' + JSON.stringify(e));
  10. }

queryDistributedVirtualDeviceId9+

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;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.queryDistributedVirtualDeviceId((err, virtualID) => {
  4. console.log('queryDistributedVirtualDeviceId err: ' + JSON.stringify(err));
  5. console.log('queryDistributedVirtualDeviceId virtualID: ' + virtualID);
  6. });
  7. } catch (e) {
  8. console.log('queryDistributedVirtualDeviceId exception: ' + JSON.stringify(e));
  9. }

queryDistributedVirtualDeviceId9+

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對象,返回分布式虛擬設(shè)備ID。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

System service exception.

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. try {
  3. accountManager.queryDistributedVirtualDeviceId().then((virtualID) => {
  4. console.log('queryDistributedVirtualDeviceId, virtualID: ' + virtualID);
  5. }).catch((err) => {
  6. console.log('queryDistributedVirtualDeviceId err: ' + JSON.stringify(err));
  7. });
  8. } catch (e) {
  9. console.log('queryDistributedVirtualDeviceId exception: ' + JSON.stringify(e));
  10. }

getOsAccountLocalIdForSerialNumber9+

getOsAccountLocalIdForSerialNumber(serialNumber: number, callback: AsyncCallback<number>): void

通過SN碼查詢與其關(guān)聯(lián)的系統(tǒng)帳號的帳號ID。使用callback異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

serialNumber

number

帳號SN碼。

callback

AsyncCallback<number>

回調(diào)函數(shù)。如果成功,err為null,data為與SN碼關(guān)聯(lián)的系統(tǒng)帳號的帳號ID;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid serialNumber.

12300003

the account indicated by serialNumber dose not exist.

示例: 查詢與SN碼12345關(guān)聯(lián)的系統(tǒng)帳號的ID

  1. let accountManager = account_osAccount.getAccountManager();
  2. let serialNumber = 12345;
  3. try {
  4. accountManager.getOsAccountLocalIdForSerialNumber(serialNumber, (err, localId)=>{
  5. console.log('ger localId err:' + JSON.stringify(err));
  6. console.log('get localId:' + localId + ' by serialNumber: ' + serialNumber);
  7. });
  8. } catch (e) {
  9. console.log('ger localId exception:' + JSON.stringify(e));
  10. }

getOsAccountLocalIdForSerialNumber9+

getOsAccountLocalIdForSerialNumber(serialNumber: number): Promise<number>

通過SN碼查詢與其關(guān)聯(lián)的系統(tǒng)帳號的帳號ID。使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

serialNumber

number

帳號SN碼。

返回值:

類型

說明

Promise<number>

Promise對象,返回與SN碼關(guān)聯(lián)的系統(tǒng)帳號的帳號ID。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid serialNumber.

12300003

the account indicated by serialNumber dose not exist.

示例: 查詢與SN碼12345關(guān)聯(lián)的系統(tǒng)帳號的ID

  1. let accountManager = account_osAccount.getAccountManager();
  2. let serialNumber = 12345;
  3. try {
  4. accountManager.getOsAccountLocalIdForSerialNumber(serialNumber).then((localId) => {
  5. console.log('getOsAccountLocalIdForSerialNumber localId: ' + localId);
  6. }).catch((err) => {
  7. console.log('getOsAccountLocalIdForSerialNumber err: ' + JSON.stringify(err));
  8. });
  9. } catch (e) {
  10. console.log('getOsAccountLocalIdForSerialNumber exception: ' + JSON.stringify(e));
  11. }

getSerialNumberForOsAccountLocalId9+

getSerialNumberForOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void

通過系統(tǒng)帳號ID獲取與該系統(tǒng)帳號關(guān)聯(lián)的SN碼。使用callback異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

localId

number

系統(tǒng)帳號ID。

callback

AsyncCallback<number>

回調(diào)函數(shù)。如果獲取成功,err為null,data為與該系統(tǒng)帳號關(guān)聯(lián)的SN碼;否則為錯誤對象。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid localId.

12300003

the account indicated by localId dose not exist.

示例: 獲取ID為100的系統(tǒng)帳號關(guān)聯(lián)的SN碼

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. try {
  4. accountManager.getSerialNumberForOsAccountLocalId(localId, (err, serialNumber)=>{
  5. console.log('ger serialNumber err:' + JSON.stringify(err));
  6. console.log('get serialNumber:' + serialNumber + ' by localId: ' + localId);
  7. });
  8. } catch (e) {
  9. console.log('ger serialNumber exception:' + JSON.stringify(e));
  10. }

getSerialNumberForOsAccountLocalId9+

getSerialNumberForOsAccountLocalId(localId: number): Promise<number>

通過系統(tǒng)帳號ID獲取與該系統(tǒng)帳號關(guān)聯(lián)的SN碼。使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

localId

number

系統(tǒng)帳號ID。

返回值:

類型

說明

Promise<number>

Promise對象,返回與該系統(tǒng)帳號關(guān)聯(lián)的SN碼。

錯誤碼:

錯誤碼ID

錯誤信息

12300001

system service exception.

12300002

invalid localId.

12300003

the account indicated by localId dose not exist.

示例: 獲取ID為100的系統(tǒng)帳號關(guān)聯(lián)的SN碼

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. try {
  4. accountManager.getSerialNumberForOsAccountLocalId(localId).then((serialNumber) => {
  5. console.log('getSerialNumberForOsAccountLocalId serialNumber: ' + serialNumber);
  6. }).catch((err) => {
  7. console.log('getSerialNumberForOsAccountLocalId err: ' + JSON.stringify(err));
  8. });
  9. } catch (e) {
  10. console.log('getSerialNumberForOsAccountLocalId exception:' + JSON.stringify(e));
  11. }

isMultiOsAccountEnable(deprecated)

isMultiOsAccountEnable(callback: AsyncCallback<boolean>): void

判斷是否支持多系統(tǒng)帳號。使用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)帳號;返回false表示不支持。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.isMultiOsAccountEnable((err, isEnabled) => {
  3. if (err) {
  4. console.log("isMultiOsAccountEnable failed, error: " + JSON.stringify(err));
  5. } else {
  6. console.log("isMultiOsAccountEnable successfully, isEnabled: " + isEnabled);
  7. }
  8. });

isMultiOsAccountEnable(deprecated)

isMultiOsAccountEnable(): Promise<boolean>

判斷是否支持多系統(tǒng)帳號。使用Promise異步回調(diào)。

說明

從 API version 7開始支持,從API version 9開始廢棄。建議使用checkMultiOsAccountEnabled。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示支持多系統(tǒng)帳號;返回false表示不支持。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.isMultiOsAccountEnable().then((isEnabled) => {
  3. console.log('isMultiOsAccountEnable successfully, isEnabled: ' + isEnabled);
  4. }).catch((err) => {
  5. console.log('isMultiOsAccountEnable failed, error: ' + JSON.stringify(err));
  6. });

isOsAccountActived(deprecated)

isOsAccountActived(localId: number, callback: AsyncCallback<boolean>): void

判斷指定系統(tǒng)帳號是否處于激活狀態(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)帳號ID。

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示帳號已激活;返回false表示帳號未激活。

示例: 判斷ID為100的系統(tǒng)帳號是否處于激活狀態(tài)

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. accountManager.isOsAccountActived(localId, (err, isActived) => {
  4. if (err) {
  5. console.log('isOsAccountActived failed, err:' + JSON.stringify(err));
  6. } else {
  7. console.log('isOsAccountActived successfully, isActived:' + isActived);
  8. }
  9. });

isOsAccountActived(deprecated)

isOsAccountActived(localId: number): Promise<boolean>

判斷指定系統(tǒng)帳號是否處于激活狀態(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)帳號ID。

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示帳號已激活;返回false表示帳號未激活。

示例: 判斷ID為100的系統(tǒng)帳號是否處于激活狀態(tài)

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. accountManager.isOsAccountActived(localId).then((isActived) => {
  4. console.log('isOsAccountActived successfully, isActived: ' + isActived);
  5. }).catch((err) => {
  6. console.log('isOsAccountActived failed, error: ' + JSON.stringify(err));
  7. });

isOsAccountConstraintEnable(deprecated)

isOsAccountConstraintEnable(localId: number, constraint: string, callback: AsyncCallback<boolean>): void

判斷指定系統(tǒng)帳號是否具有指定約束。使用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)帳號ID。

constraint

string

指定的約束名稱。

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示已使能指定的約束;返回false表示未使能指定的約束。

示例: 判斷ID為100的系統(tǒng)帳號是否有禁止使用Wi-Fi的約束

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. let constraint = "constraint.wifi";
  4. accountManager.isOsAccountConstraintEnable(localId, constraint, (err, isEnabled) => {
  5. if (err) {
  6. console.log("isOsAccountConstraintEnable failed, error:" + JSON.stringify(err));
  7. } else {
  8. console.log("isOsAccountConstraintEnable successfully, isEnabled:" + isEnabled);
  9. }
  10. });

isOsAccountConstraintEnable(deprecated)

isOsAccountConstraintEnable(localId: number, constraint: string): Promise<boolean>

判斷指定系統(tǒng)帳號是否具有指定約束。使用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)帳號ID。

constraint

string

指定的約束名稱。

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示已使能指定的約束;返回false表示未使能指定的約束。

示例: 判斷ID為100的系統(tǒng)帳號是否有禁止使用Wi-Fi的約束

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. let constraint = "constraint.wifi";
  4. accountManager.isOsAccountConstraintEnable(localId, constraint).then((isEnabled) => {
  5. console.log("isOsAccountConstraintEnable successfully, isEnabled: " + isEnabled);
  6. }).catch((err) => {
  7. console.log("isOsAccountConstraintEnable err: " + JSON.stringify(err));
  8. });

isTestOsAccount(deprecated)

isTestOsAccount(callback: AsyncCallback<boolean>): void

檢查當(dāng)前系統(tǒng)帳號是否為測試帳號。使用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)前帳號為測試帳號;返回false表示當(dāng)前帳號非測試帳號。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.isTestOsAccount((err, isTestable) => {
  3. if (err) {
  4. console.log("isTestOsAccount failed, error: " + JSON.stringify(err));
  5. } else {
  6. console.log("isTestOsAccount successfully, isTestable: " + isTestable);
  7. }
  8. });

isTestOsAccount(deprecated)

isTestOsAccount(): Promise<boolean>

檢查當(dāng)前系統(tǒng)帳號是否為測試帳號。使用Promise異步回調(diào)。

說明

從 API version 7開始支持,從API version 9開始廢棄。建議使用checkOsAccountTestable。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示當(dāng)前帳號為測試帳號;返回false表示當(dāng)前帳號非測試帳號。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.isTestOsAccount().then((isTestable) => {
  3. console.log("isTestOsAccount successfully, isTestable: " + isTestable);
  4. }).catch((err) => {
  5. console.log("isTestOsAccount failed, error: " + JSON.stringify(err));
  6. });

isOsAccountVerified(deprecated)

isOsAccountVerified(callback: AsyncCallback<boolean>): void

檢查當(dāng)前系統(tǒng)帳號是否已驗證。使用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表示指定帳號已驗證;返回false表示指定帳號未驗證。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.isOsAccountVerified((err, isVerified) => {
  3. if (err) {
  4. console.log("isOsAccountVerified failed, error: " + JSON.stringify(err));
  5. } else {
  6. console.log("isOsAccountVerified successfully, isVerified: " + isVerified);
  7. }
  8. });

isOsAccountVerified(deprecated)

isOsAccountVerified(localId: number, callback: AsyncCallback<boolean>): void

檢查指定系統(tǒng)帳號是否已驗證。使用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)帳號ID。

callback

AsyncCallback<boolean>

回調(diào)函數(shù)。返回true表示指定帳號已驗證;返回false表示指定帳號未驗證。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. accountManager.isOsAccountVerified(localId, (err, isVerified) => {
  4. if (err) {
  5. console.log("isOsAccountVerified failed, error: " + JSON.stringify(err));
  6. } else {
  7. console.log("isOsAccountVerified successfully, isVerified: " + isVerified);
  8. }
  9. });

isOsAccountVerified(deprecated)

isOsAccountVerified(localId?: number): Promise<boolean>

檢查指定系統(tǒng)帳號是否已驗證。使用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)帳號ID。不填則檢查當(dāng)前系統(tǒng)帳號是否已驗證。

返回值:

類型

說明

Promise<boolean>

Promise對象。返回true表示指定帳號已驗證;返回false表示指定帳號未驗證。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.isOsAccountVerified(localId).then((isVerified) => {
  3. console.log("isOsAccountVerified successfully, isVerified: " + isVerified);
  4. }).catch((err) => {
  5. console.log("isOsAccountVerified failed, error: " + JSON.stringify(err));
  6. });

getCreatedOsAccountsCount(deprecated)

getCreatedOsAccountsCount(callback: AsyncCallback<number>): void

獲取已創(chuàng)建的系統(tǒng)帳號數(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)獲取成功時,err為null,data為已創(chuàng)建的系統(tǒng)帳號的數(shù)量;否則為錯誤對象。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.getCreatedOsAccountsCount((err, count)=>{
  3. if (err) {
  4. console.log("getCreatedOsAccountsCount failed, error: " + JSON.stringify(err));
  5. } else {
  6. console.log("getCreatedOsAccountsCount successfully, count: " + count);
  7. }
  8. });

getCreatedOsAccountsCount(deprecated)

getCreatedOsAccountsCount(): Promise<number>

獲取已創(chuàng)建的系統(tǒng)帳號數(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對象,返回已創(chuàng)建的系統(tǒng)帳號的數(shù)量。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.getCreatedOsAccountsCount().then((count) => {
  3. console.log("getCreatedOsAccountsCount successfully, count: " + count);
  4. }).catch((err) => {
  5. console.log("getCreatedOsAccountsCount failed, error: " + JSON.stringify(err));
  6. });

getOsAccountLocalIdFromProcess(deprecated)

getOsAccountLocalIdFromProcess(callback: AsyncCallback<number>): void

獲取當(dāng)前進(jìn)程所屬的系統(tǒng)帳號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)獲取成功時,err為null,data為當(dāng)前進(jìn)程所屬的系統(tǒng)帳號ID;否則為錯誤對象。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.getOsAccountLocalIdFromProcess((err, localId) => {
  3. if (err) {
  4. console.log("getOsAccountLocalIdFromProcess failed, error: " + JSON.stringify(err));
  5. } else {
  6. console.log("getOsAccountLocalIdFromProcess successfully, localId: " + localId);
  7. }
  8. });

getOsAccountLocalIdFromProcess(deprecated)

getOsAccountLocalIdFromProcess(): Promise<number>

獲取當(dāng)前進(jìn)程所屬的系統(tǒng)帳號ID,使用Promise異步回調(diào)。

說明

從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalId。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<number>

Promise對象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號ID。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.getOsAccountLocalIdFromProcess().then((localId) => {
  3. console.log('getOsAccountLocalIdFromProcess successfully, localId: ' + localId);
  4. }).catch((err) => {
  5. console.log('getOsAccountLocalIdFromProcess failed, error: ' + JSON.stringify(err));
  6. });

getOsAccountLocalIdFromUid(deprecated)

getOsAccountLocalIdFromUid(uid: number, callback: AsyncCallback<number>): void

根據(jù)uid查詢對應(yīng)的系統(tǒng)帳號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為對應(yīng)的系統(tǒng)帳號ID;否則為錯誤對象。

示例: 查詢值為12345678的uid所屬的系統(tǒng)帳號ID

  1. let accountManager = account_osAccount.getAccountManager();
  2. let uid = 12345678;
  3. accountManager.getOsAccountLocalIdFromUid(uid, (err, localId) => {
  4. if (err) {
  5. console.log("getOsAccountLocalIdFromUid failed, error: " + JSON.stringify(err));
  6. } else {
  7. console.log("getOsAccountLocalIdFromUid successfully, localId: " + localId);
  8. }
  9. });

getOsAccountLocalIdFromUid(deprecated)

getOsAccountLocalIdFromUid(uid: number): Promise<number>

根據(jù)uid查詢對應(yīng)的系統(tǒng)帳號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對象,返回uid對應(yīng)的系統(tǒng)帳號ID。

示例: 查詢值為12345678的uid所屬的系統(tǒng)帳號ID

  1. let accountManager = account_osAccount.getAccountManager();
  2. let uid = 12345678;
  3. accountManager.getOsAccountLocalIdFromUid(uid).then((localId) => {
  4. console.log("getOsAccountLocalIdFromUid successfully, localId: " + localId);
  5. }).catch((err) => {
  6. console.log("getOsAccountLocalIdFromUid failed, error: " + JSON.stringify(err));
  7. });

getOsAccountLocalIdFromDomain(deprecated)

getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void

根據(jù)域帳號信息,獲取與其關(guān)聯(lián)的系統(tǒng)帳號的帳號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

DomainAccountInfo

域帳號信息。

callback

AsyncCallback<number>

回調(diào)函數(shù),如果獲取成功,err為null,data為域帳號關(guān)聯(lián)的系統(tǒng)帳號ID;否則為錯誤對象。

示例:

  1. let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
  2. let accountManager = account_osAccount.getAccountManager();
  3. accountManager.getOsAccountLocalIdFromDomain(domainInfo, (err, localId) => {
  4. if (err) {
  5. console.log("getOsAccountLocalIdFromDomain failed, error: " + JSON.stringify(err));
  6. } else {
  7. console.log("getOsAccountLocalIdFromDomain successfully, localId: " + localId);
  8. }
  9. });

getOsAccountLocalIdFromDomain(deprecated)

getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise<number>

根據(jù)域帳號信息,獲取與其關(guān)聯(lián)的系統(tǒng)帳號的帳號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

DomainAccountInfo

域帳號信息。

返回值:

類型

說明

Promise<number>

Promise對象,返回域帳號關(guān)聯(lián)的系統(tǒng)帳號ID。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. let domainInfo = {domain: 'testDomain', accountName: 'testAccountName'};
  3. accountManager.getOsAccountLocalIdFromDomain(domainInfo).then((localId) => {
  4. console.log('getOsAccountLocalIdFromDomain successfully, localId: ' + localId);
  5. }).catch((err) => {
  6. console.log('getOsAccountLocalIdFromDomain failed, error: ' + JSON.stringify(err));
  7. });

getOsAccountAllConstraints(deprecated)

getOsAccountAllConstraints(localId: number, callback: AsyncCallback<Array<string>>): void

獲取指定系統(tǒng)帳號的全部約束。使用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)帳號ID。

callback

AsyncCallback<Array<string>>

回調(diào)函數(shù)。如果獲取成功,err為null,data為指定系統(tǒng)帳號的全部約束;否則為錯誤對象。

示例: 獲取ID為100的系統(tǒng)帳號的全部約束

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. accountManager.getOsAccountAllConstraints(localId, (err, constraints)=>{
  4. console.log('getOsAccountAllConstraints err:' + JSON.stringify(err));
  5. console.log('getOsAccountAllConstraints:' + JSON.stringify(constraints));
  6. });

getOsAccountAllConstraints(deprecated)

getOsAccountAllConstraints(localId: number): Promise<Array<string>>

說明

從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountConstraints。

獲取指定系統(tǒng)帳號的全部約束。使用Promise異步回調(diào)。

需要權(quán)限: ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

localId

number

系統(tǒng)帳號ID。

返回值:

類型

說明

Promise<Array<string>>

Promise對象,返回指定系統(tǒng)帳號的全部約束。

示例: 獲取ID為100的系統(tǒng)帳號的全部約束

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. accountManager.getOsAccountAllConstraints(localId).then((constraints) => {
  4. console.log('getOsAccountAllConstraints, constraints: ' + constraints);
  5. }).catch((err) => {
  6. console.log('getOsAccountAllConstraints err: ' + JSON.stringify(err));
  7. });

queryActivatedOsAccountIds(deprecated)

queryActivatedOsAccountIds(callback: AsyncCallback<Array<number>>): void

查詢當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號的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)帳號的ID列表;否則為錯誤對象。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.queryActivatedOsAccountIds((err, idArray)=>{
  3. console.log('queryActivatedOsAccountIds err:' + JSON.stringify(err));
  4. console.log('queryActivatedOsAccountIds idArray length:' + idArray.length);
  5. for(let i=0;i<idArray.length;i++) {
  6. console.info('activated os account id: ' + idArray[i]);
  7. }
  8. });

queryActivatedOsAccountIds(deprecated)

queryActivatedOsAccountIds(): Promise<Array<number>>

說明

從 API version 8開始支持,從API version 9開始廢棄。建議使用getActivatedOsAccountLocalIds。

查詢當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號的ID列表。使用Promise異步回調(diào)。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<Array<number>>

Promise對象,返回當(dāng)前處于激活狀態(tài)的系統(tǒng)帳號的ID列表。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.queryActivatedOsAccountIds().then((idArray) => {
  3. console.log('queryActivatedOsAccountIds, idArray: ' + idArray);
  4. }).catch((err) => {
  5. console.log('queryActivatedOsAccountIds err: ' + JSON.stringify(err));
  6. });

queryCurrentOsAccount(deprecated)

queryCurrentOsAccount(callback: AsyncCallback<OsAccountInfo>): void

查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的信息。使用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)帳號信息;否則為錯誤對象。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.queryCurrentOsAccount((err, curAccountInfo)=>{
  3. console.log('queryCurrentOsAccount err:' + JSON.stringify(err));
  4. console.log('queryCurrentOsAccount curAccountInfo:' + JSON.stringify(curAccountInfo));
  5. });

queryCurrentOsAccount(deprecated)

queryCurrentOsAccount(): Promise<OsAccountInfo>

查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的信息。使用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對象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號信息。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.queryCurrentOsAccount().then((accountInfo) => {
  3. console.log('queryCurrentOsAccount, accountInfo: ' + JSON.stringify(accountInfo));
  4. }).catch((err) => {
  5. console.log('queryCurrentOsAccount err: ' + JSON.stringify(err));
  6. });

getOsAccountTypeFromProcess(deprecated)

getOsAccountTypeFromProcess(callback: AsyncCallback<OsAccountType>): void

查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的帳號類型。使用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)帳號的帳號類型;否則為錯誤對象。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.getOsAccountTypeFromProcess((err, accountType) => {
  3. console.log('getOsAccountTypeFromProcess err: ' + JSON.stringify(err));
  4. console.log('getOsAccountTypeFromProcess accountType: ' + accountType);
  5. });

getOsAccountTypeFromProcess(deprecated)

getOsAccountTypeFromProcess(): Promise<OsAccountType>

查詢當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的帳號類型。使用Promise異步回調(diào)。

說明

從 API version 7開始支持,從API version 9開始廢棄。建議使用getOsAccountType。

系統(tǒng)能力: SystemCapability.Account.OsAccount

返回值:

類型

說明

Promise<OsAccountType>

Promise對象,返回當(dāng)前進(jìn)程所屬的系統(tǒng)帳號的帳號類型。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.getOsAccountTypeFromProcess().then((accountType) => {
  3. console.log('getOsAccountTypeFromProcess, accountType: ' + accountType);
  4. }).catch((err) => {
  5. console.log('getOsAccountTypeFromProcess err: ' + JSON.stringify(err));
  6. });

getDistributedVirtualDeviceId(deprecated)

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;否則為錯誤對象。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.getDistributedVirtualDeviceId((err, virtualID) => {
  3. console.log('getDistributedVirtualDeviceId err: ' + JSON.stringify(err));
  4. console.log('getDistributedVirtualDeviceId virtualID: ' + virtualID);
  5. });

getDistributedVirtualDeviceId(deprecated)

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對象,返回分布式虛擬設(shè)備ID。

示例:

  1. let accountManager = account_osAccount.getAccountManager();
  2. accountManager.getDistributedVirtualDeviceId().then((virtualID) => {
  3. console.log('getDistributedVirtualDeviceId, virtualID: ' + virtualID);
  4. }).catch((err) => {
  5. console.log('getDistributedVirtualDeviceId err: ' + JSON.stringify(err));
  6. });

getOsAccountLocalIdBySerialNumber(deprecated)

getOsAccountLocalIdBySerialNumber(serialNumber: number, callback: AsyncCallback<number>): void

通過SN碼查詢與其關(guān)聯(lián)的系統(tǒng)帳號的帳號ID。使用callback異步回調(diào)。

說明

從 API version 8開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalIdForSerialNumber。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

serialNumber

number

帳號SN碼。

callback

AsyncCallback<number>

回調(diào)函數(shù)。如果查詢成功,err為null,data為與SN碼關(guān)聯(lián)的系統(tǒng)帳號的帳號ID;否則為錯誤對象。

示例: 查詢與SN碼12345關(guān)聯(lián)的系統(tǒng)帳號的ID

  1. let accountManager = account_osAccount.getAccountManager();
  2. let serialNumber = 12345;
  3. accountManager.getOsAccountLocalIdBySerialNumber(serialNumber, (err, localId)=>{
  4. console.log('ger localId err:' + JSON.stringify(err));
  5. console.log('get localId:' + localId + ' by serialNumber: ' + serialNumber);
  6. });

getOsAccountLocalIdBySerialNumber(deprecated)

getOsAccountLocalIdBySerialNumber(serialNumber: number): Promise<number>

通過SN碼查詢與其關(guān)聯(lián)的系統(tǒng)帳號的帳號ID。使用Promise異步回調(diào)。

說明

從 API version 8開始支持,從API version 9開始廢棄。建議使用getOsAccountLocalIdForSerialNumber。

系統(tǒng)能力: SystemCapability.Account.OsAccount

參數(shù):

參數(shù)名

類型

必填

說明

serialNumber

number

帳號SN碼。

返回值:

類型

說明

Promise<number>

Promise對象,返回與SN碼關(guān)聯(lián)的系統(tǒng)帳號的帳號ID。

示例: 查詢與SN碼12345關(guān)聯(lián)的系統(tǒng)帳號的ID

  1. let accountManager = account_osAccount.getAccountManager();
  2. let serialNumber = 12345;
  3. accountManager.getOsAccountLocalIdBySerialNumber(serialNumber).then((localId) => {
  4. console.log('getOsAccountLocalIdBySerialNumber localId: ' + localId);
  5. }).catch((err) => {
  6. console.log('getOsAccountLocalIdBySerialNumber err: ' + JSON.stringify(err));
  7. });

getSerialNumberByOsAccountLocalId(deprecated)

getSerialNumberByOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void

通過系統(tǒng)帳號ID獲取與該系統(tǒng)帳號關(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)帳號ID。

callback

AsyncCallback<number>

回調(diào)函數(shù)。如果獲取成功,err為null,data為與該系統(tǒng)帳號關(guān)聯(lián)的SN碼;否則為錯誤對象。

示例: 獲取ID為100的系統(tǒng)帳號關(guān)聯(lián)的SN碼

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. accountManager.getSerialNumberByOsAccountLocalId(localId, (err, serialNumber)=>{
  4. console.log('ger serialNumber err:' + JSON.stringify(err));
  5. console.log('get serialNumber:' + serialNumber + ' by localId: ' + localId);
  6. });

getSerialNumberByOsAccountLocalId(deprecated)

getSerialNumberByOsAccountLocalId(localId: number): Promise<number>

通過系統(tǒng)帳號ID獲取與該系統(tǒng)帳號關(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)帳號ID。

返回值:

類型

說明

Promise<number>

Promise對象,返回與該系統(tǒng)帳號關(guān)聯(lián)的SN碼。

示例: 獲取ID為100的系統(tǒng)帳號關(guān)聯(lián)的SN碼

  1. let accountManager = account_osAccount.getAccountManager();
  2. let localId = 100;
  3. accountManager.getSerialNumberByOsAccountLocalId(localId).then((serialNumber) => {
  4. console.log('getSerialNumberByOsAccountLocalId serialNumber: ' + serialNumber);
  5. }).catch((err) => {
  6. console.log('getSerialNumberByOsAccountLocalId err: ' + JSON.stringify(err));
  7. });

OsAccountInfo

表示系統(tǒng)帳號信息。

系統(tǒng)能力: 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Account.OsAccount。

名稱

類型

必填

說明

localId

number

系統(tǒng)帳號ID。

localName

string

系統(tǒng)帳號名稱。

type

OsAccountType

系統(tǒng)帳號類型

constraints

Array<string>

系統(tǒng)帳號約束

isVerified8+

boolean

帳號是否驗證

photo8+

string

系統(tǒng)帳號頭像

createTime8+

number

系統(tǒng)帳號創(chuàng)建時間

lastLoginTime8+

number

系統(tǒng)帳號最后一次登錄時間

serialNumber8+

number

系統(tǒng)帳號SN碼

isActived8+

boolean

系統(tǒng)帳號激活狀態(tài)

isCreateCompleted8+

boolean

系統(tǒng)帳號創(chuàng)建是否完整

distributedInfo

distributedAccount.DistributedInfo

分布式帳號信息

domainInfo8+

DomainAccountInfo

域帳號信息

DomainAccountInfo8+

表示域帳號信息。

系統(tǒng)能力: 以下各項對應(yīng)的系統(tǒng)能力均為SystemCapability.Account.OsAccount。

名稱

類型

必填

說明

domain

string

域名。

accountName

string

域帳號名。

系統(tǒng)帳號約束列表

約束

說明

constraint.wifi

禁止使用Wi-Fi

constraint.wifi.set

禁止配置Wi-Fi

constraint.locale.set

禁止配置設(shè)備語言

constraint.app.accounts

禁止添加和刪除應(yīng)用帳號

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

禁止配置日期時間和時區(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)用程序驗證

constraint.cell.broadcasts.set

禁止配置小區(qū)廣播

constraint.mobile.networks.set

禁止配置移動網(wǎng)絡(luò)

constraint.control.apps

禁止在設(shè)置或啟動模塊中修改應(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)錯誤對話框

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

禁止在后臺運(yùn)行

constraint.data.roam

禁止漫游通話時使用蜂窩數(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

禁止使用自動填充服務(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)閉的超時

constraint.print

禁止打印

constraint.private.dns.set

禁止配置專用DNS

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號