系統帳號管理

本模塊提供管理系統帳號的一些基礎能力，包括系統帳號的添加、刪除、查詢、設置、訂閱、啟動等功能，提供系統帳號數據落盤的能力。

說明： 本模塊首批接口從API version 7開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導入模塊

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

account_osAccount.getAccountManager

getAccountManager(): AccountManager

獲取系統帳號能力的實例。

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();

OsAccountType

枚舉，系統帳號類型。

系統能力： 以下各項對應的系統能力均為SystemCapability.Account.OsAccount。

AccountManager

管理系統帳號能力的類。

activateOsAccount

activateOsAccount(localId: number, callback: AsyncCallback): void

激活指定系統帳號，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**激活ID為100的系統帳號

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.activateOsAccount(localId, (err)= >{
  console.log("activateOsAccount err:" + JSON.stringify(err));
});

activateOsAccount

activateOsAccount(localId: number): Promise

激活指定系統帳號，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**激活ID為100的系統帳號

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.activateOsAccount(localId).then(() = > {
  console.log("activateOsAccount success");
}).catch((err) = > {
  console.log("activateOsAccount err:" + JSON.stringify(err));
});

isMultiOsAccountEnable

isMultiOsAccountEnable(callback: AsyncCallback): void

判斷是否支持多系統帳號，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.isMultiOsAccountEnable((err, isEnabled) = > {
  console.log("isMultiOsAccountEnable err: " + JSON.stringify(err));
  console.log('isMultiOsAccountEnable isEnabled: ' + isEnabled);
});

isMultiOsAccountEnable

isMultiOsAccountEnable(): Promise

判斷是否支持多系統帳號，使用Promise方式異步返回結果。

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.isMultiOsAccountEnable().then((isEnabled) = > {
  console.log('isMultiOsAccountEnable, isEnabled: ' + isEnabled);
}).catch((err) = > {
  console.log("isMultiOsAccountEnable err: "  + JSON.stringify(err));
});

isOsAccountActived

isOsAccountActived(localId: number, callback: AsyncCallback): void

判斷指定系統帳號是否處于激活狀態，使用callback回調異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**判斷ID為100的系統帳號是否處于激活狀態

const accountManager = account_osAccount.getAccountManager();
var osLocalId = 100;
accountManager.isOsAccountActived(osLocalId, (err, isActive)= >{
  console.log("isOsAccountActived err:" + JSON.stringify(err));
  console.log("isOsAccountActived isActive:" + isActive);
});

isOsAccountActived

isOsAccountActived(localId: number): Promise

判斷指定系統帳號是否處于激活狀態，使用Promise方式異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**判斷ID為100的系統帳號是否處于激活狀態

const accountManager = account_osAccount.getAccountManager();
var osLocalId = 100;
accountManager.isOsAccountActived(osLocalId).then((isActive) = > {
  console.log('isOsAccountActived, isActive: ' + isActive);
}).catch((err) = > {
  console.log("isOsAccountActived err: "  + JSON.stringify(err));
});

isOsAccountConstraintEnable

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

判斷指定系統帳號是否具有指定約束，使用callback回調異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**判斷ID為100的系統帳號是否有禁止使用wifi的約束

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.isOsAccountConstraintEnable(localId, "constraint.wifi", (err, isConstraintEnabled)= >{
  console.log("isOsAccountConstraintEnable err:" + JSON.stringify(err));
  console.log("isOsAccountConstraintEnable isConstraintEnabled:" + isConstraintEnabled);
});

isOsAccountConstraintEnable

isOsAccountConstraintEnable(localId: number, constraint: string): Promise

判斷指定系統帳號是否具有指定約束，使用Promise方式異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**判斷ID為100的系統帳號是否有禁止使用wifi的約束

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.isOsAccountConstraintEnable(localId, "constraint.wifi").then((isConstraintEnabled) = > {
  console.log('isOsAccountConstraintEnable, isConstraintEnabled: ' + isConstraintEnabled);
}).catch((err) = > {
  console.log("isOsAccountConstraintEnable err: "  + JSON.stringify(err));
});

isTestOsAccount

isTestOsAccount(callback: AsyncCallback): void

檢查當前系統帳號是否為測試帳號，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.isTestOsAccount((err, isTest) = > {
  console.log("isTestOsAccount err: " + JSON.stringify(err));
  console.log('isTestOsAccount isTest: ' + isTest);
});

isTestOsAccount

isTestOsAccount(): Promise

檢查當前系統帳號是否為測試帳號，使用Promise方式異步返回結果。

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.isTestOsAccount().then((isTest) = > {
  console.log('isTestOsAccount, isTest: ' + isTest);
}).catch((err) = > {
  console.log("isTestOsAccount err: "  + JSON.stringify(err));
});

isOsAccountVerified

isOsAccountVerified(callback: AsyncCallback): void

檢查當前系統帳號是否已驗證，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified((err, isVerified) = > {
  console.log("isOsAccountVerified err: " + JSON.stringify(err));
  console.log('isOsAccountVerified isVerified: ' + isVerified);
});

isOsAccountVerified

isOsAccountVerified(localId: number, callback: AsyncCallback): void

檢查指定系統帳號是否已驗證，使用callback回調異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified((err, isVerified) = > {
  console.log("isOsAccountVerified err: " + JSON.stringify(err));
  console.log('isOsAccountVerified isVerified: ' + isVerified);
});

isOsAccountVerified

isOsAccountVerified(localId?: number): Promise

檢查指定系統帳號是否已驗證，使用Promise方式異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.isOsAccountVerified().then((isVerified) = > {
  console.log('isOsAccountVerified, isVerified: ' + isVerified);
}).catch((err) = > {
  console.log("isOsAccountVerified err: "  + JSON.stringify(err));
});

removeOsAccount

removeOsAccount(localId: number, callback: AsyncCallback): void

刪除指定系統帳號，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
var createIocalId;
osAccountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)= >{
  createIocalId = osAccountInfo.localId;
});
accountManager.removeOsAccount(createIocalId, (err)= >{
  console.log("removeOsAccount err:" + JSON.stringify(err));
});

removeOsAccount

removeOsAccount(localId: number): Promise

刪除指定系統帳號，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
var createIocalId;
osAccountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)= >{
  createIocalId = osAccountInfo.localId;
});
createIocalId = osAccount.localId;
accountManager.removeOsAccount(createIocalId).then(() = > {
  console.log('removeOsAccount Success');
}).catch(() = > {
  console.log("removeOsAccount err: "  + JSON.stringify(err));
});

setOsAccountConstraints

setOsAccountConstraints(localId: number, constraints: Array, enable: boolean,callback: AsyncCallback): void

為指定系統帳號設置/刪除約束，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**給ID為100的系統帳號設置禁止使用wifi的約束

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.setOsAccountConstraints(localId, ["constraint.wifi"], true, (err)= >{
  console.log("setOsAccountConstraints err:" + JSON.stringify(err));
});

setOsAccountConstraints

setOsAccountConstraints(localId: number, constraints: Array, enable: boolean): Promise

為指定系統帳號設置/刪除約束，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**刪除ID為100的系統帳號的禁止使用wifi的約束

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.setOsAccountConstraints(localId, ["constraint.location.set"], false).then(() = > {
  console.log('setOsAccountConstraints Success');
}).catch((err) = > {
  console.log("setOsAccountConstraints err: "  + JSON.stringify(err));
});

setOsAccountName

setOsAccountName(localId: number, localName: string, callback: AsyncCallback): void

設置指定系統帳號的帳號名，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**將ID為100的系統帳號的帳號名設置成demoName

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
var newName = "demoName";
accountManager.setOsAccountName(localId, newName, (err)= >{
  console.debug("setOsAccountName err:" + JSON.stringify(err));
});

setOsAccountName

setOsAccountName(localId: number, localName: string): Promise

設置指定系統帳號的帳號名，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**將ID為100的系統帳號的帳號名設置成demoName

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
var nameLimit = "demoName";
accountManager.setOsAccountName(localId, nameLimit).then(() = > {
  console.log('setOsAccountName Success');
}).catch((err) = > {
  console.log("setOsAccountName err: "  + JSON.stringify(err));
});

getCreatedOsAccountsCount

getCreatedOsAccountsCount(callback: AsyncCallback): void

獲取已創建的系統帳號數量，使用callback回調異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.getCreatedOsAccountsCount((err, accountCnt)= >{
  console.log("obtains the number of all os accounts created err:" + JSON.stringify(err));
  console.log("obtains the number of all os accounts created accountCnt:" + accountCnt);
});

getCreatedOsAccountsCount

getCreatedOsAccountsCount(): Promise

獲取已創建的系統帳號數量，使用Promise方式異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.getCreatedOsAccountsCount().then((accountCnt) = > {
  console.log('getCreatedOsAccountsCount, accountCnt: ' + accountCnt);
}).catch((err) = > {
  console.log("getCreatedOsAccountsCount err: "  + JSON.stringify(err));
});

getOsAccountLocalIdFromProcess

getOsAccountLocalIdFromProcess(callback: AsyncCallback): void

獲取當前進程所屬的系統帳號的帳號ID，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromProcess((err, accountID) = > {
  console.log("getOsAccountLocalIdFromProcess err: " + JSON.stringify(err));
  console.log('getOsAccountLocalIdFromProcess accountID: ' + accountID);
});

getOsAccountLocalIdFromProcess

getOsAccountLocalIdFromProcess(): Promise

獲取當前進程所屬的系統帳號的帳號ID，使用Promise方式異步返回結果。

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromProcess().then((accountID) = > {
  console.log('getOsAccountLocalIdFromProcess, accountID: ' + accountID);
}).catch((err) = > {
  console.log("getOsAccountLocalIdFromProcess err: "  + JSON.stringify(err));
});

getOsAccountLocalIdFromUid

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

從進程uid中獲取該uid所屬的系統帳號的帳號ID，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**查詢值為12345678的uid所屬的系統帳號的帳號ID

const accountManager = account_osAccount.getAccountManager();
let uid = 12345678;
accountManager.getOsAccountLocalIdFromUid(uid, (err, accountID) = > {
  console.log("getOsAccountLocalIdFromUid err: " + JSON.stringify(err));
  console.log('getOsAccountLocalIdFromUid: ' + accountID);
});

getOsAccountLocalIdFromUid

getOsAccountLocalIdFromUid(uid: number): Promise

從進程uid中獲取該uid所屬的系統帳號的帳號ID，使用Promise方式異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**查詢值為12345678的uid所屬的系統帳號的帳號ID

const accountManager = account_osAccount.getAccountManager();
let uid = 12345678;
accountManager.getOsAccountLocalIdFromUid(uid).then((accountID) = > {
  console.log('getOsAccountLocalIdFromUid: ' + accountID);
}).catch((err) = > {
  console.log("getOsAccountLocalIdFromUid err: "  + JSON.stringify(err));
});

getOsAccountLocalIdFromDomain8+

getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback): void

根據域帳號信息，獲取與其關聯的系統帳號的帳號ID。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountLocalIdFromDomain(domainInfo, (err, accountID) = > {
  console.log("getOsAccountLocalIdFromDomain: " + JSON.stringify(err));
  console.log('getOsAccountLocalIdFromDomain: ' + accountID);
});

getOsAccountLocalIdFromDomain8+

getOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise

根據域帳號信息，獲取與其關聯的系統帳號的帳號ID，使用Promise方式異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
accountManager.getOsAccountLocalIdFromDomain(domainInfo).then((accountID) = > {
  console.log('getOsAccountLocalIdFromDomain: ' + accountID);
}).catch((err) = > {
  console.log("getOsAccountLocalIdFromDomain err: "  + JSON.stringify(err));
});

queryMaxOsAccountNumber

queryMaxOsAccountNumber(callback: AsyncCallback): void

查詢允許創建的系統帳號的最大數量，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.queryMaxOsAccountNumber((err, maxCnt)= >{
  console.log("queryMaxOsAccountNumber err:" + JSON.stringify(err));
  console.log("queryMaxOsAccountNumber maxCnt:" + maxCnt);
});

queryMaxOsAccountNumber

queryMaxOsAccountNumber(): Promise

查詢允許創建的系統帳號的最大數量，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.queryMaxOsAccountNumber().then((maxCnt) = > {
  console.log('queryMaxOsAccountNumber, maxCnt: ' + maxCnt);
}).catch((err) = > {
  console.log("queryMaxOsAccountNumber err: "  + JSON.stringify(err));
});

getOsAccountAllConstraints

getOsAccountAllConstraints(localId: number, callback: AsyncCallback>): void

獲取指定系統帳號的全部約束，使用callback回調異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**獲取ID為100的系統帳號的全部約束

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getOsAccountAllConstraints(localId, (err, constraints)= >{
  console.log("getOsAccountAllConstraints err:" + JSON.stringify(err));
  console.log("getOsAccountAllConstraints:" + JSON.stringify(constraints));
});

getOsAccountAllConstraints

getOsAccountAllConstraints(localId: number): Promise>

獲取指定系統帳號的全部約束，使用Promise方式異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**獲取ID為100的系統帳號的全部約束

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getOsAccountAllConstraints(localId).then((constraints) = > {
  console.log("getOsAccountAllConstraints, constraints: " + constraints);
}).catch((err) = > {
  console.log("getOsAccountAllConstraints err: "  + JSON.stringify(err));
});

queryAllCreatedOsAccounts

queryAllCreatedOsAccounts(callback: AsyncCallback>): void

查詢已創建的所有系統帳號的信息列表，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Account.OsAccount

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.queryAllCreatedOsAccounts((err, accountArr)= >{
  console.log("queryAllCreatedOsAccounts err:" + JSON.stringify(err));
  console.log("queryAllCreatedOsAccounts accountArr:" + JSON.stringify(accountArr));
});

queryAllCreatedOsAccounts

queryAllCreatedOsAccounts(): Promise>

查詢已創建的所有系統帳號的信息列表，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

系統能力： SystemCapability.Account.OsAccount

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.queryAllCreatedOsAccounts().then((accountArr) = > {
  console.log('queryAllCreatedOsAccounts, accountArr: ' + JSON.stringify(accountArr));
}).catch((err) = > {
  console.log("queryAllCreatedOsAccounts err: "  + JSON.stringify(err));
});

queryActivatedOsAccountIds8+

queryActivatedOsAccountIds(callback: AsyncCallback>): void

查詢當前處于激活狀態的系統帳號的ID列表，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.queryActivatedOsAccountIds((err, idArray)= >{
  console.log("queryActivatedOsAccountIds err:" + JSON.stringify(err));
  console.log("queryActivatedOsAccountIds idArray length:" + idArray.length);
  for(var i=0;i< idArray.length;i++) {
    console.info("activated os account id: " + idArray[i]);
  }
});

queryActivatedOsAccountIds8+

queryActivatedOsAccountIds(): Promise>

查詢當前處于激活狀態的系統帳號的ID列表，使用Promise方式異步返回結果。

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.queryActivatedOsAccountIds().then((idArray) = > {
  console.log('queryActivatedOsAccountIds, idArray: ' + idArray);
}).catch((err) = > {
  console.log("queryActivatedOsAccountIds err: "  + JSON.stringify(err));
});

createOsAccount

createOsAccount(localName: string, type: OsAccountType, callback: AsyncCallback): void

創建一個系統帳號，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.createOsAccount("testName", osaccount.OsAccountType.NORMAL, (err, osAccountInfo)= >{
  console.log("createOsAccount err:" + JSON.stringify(err));
  console.log("createOsAccount osAccountInfo:" + JSON.stringify(osAccountInfo));
});

createOsAccount

createOsAccount(localName: string, type: OsAccountType): Promise

創建一個系統帳號，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.createOsAccount("testAccountName", osaccount.OsAccountType.NORMAL).then((accountInfo) = > {
  console.log("createOsAccount, accountInfo: " + JSON.stringify(accountInfo));
}).catch((err) = > {
  console.log("createOsAccount err: "  + JSON.stringify(err));
});

createOsAccountForDomain8+

createOsAccountForDomain(type: OsAccountType, domainInfo: DomainAccountInfo, callback: AsyncCallback): void

根據域帳號信息，創建一個系統帳號并將其與域帳號關聯，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
accountManager.createOsAccountForDomain(osaccount.OsAccountType.NORMAL, domainInfo, (err, osAccountInfo)= >{
  console.log("createOsAccountForDomain err:" + JSON.stringify(err));
  console.log("createOsAccountForDomain osAccountInfo:" + JSON.stringify(osAccountInfo));
});

createOsAccountForDomain8+

createOsAccountForDomain(type: OsAccountType, domainInfo: DomainAccountInfo): Promise

根據傳入的域帳號信息，創建與其關聯的系統帳號，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
var domainInfo = {domain: "testDomain", accountName: "testAccountName"};
accountManager.createOsAccountForDomain(osaccount.OsAccountType.NORMAL, domainInfo).then((accountInfo) = > {
  console.log("createOsAccountForDomain, account info: " + JSON.stringify(accountInfo));
}).catch((err) = > {
  console.log("createOsAccountForDomain err: "  + JSON.stringify(err));
});

queryCurrentOsAccount

queryCurrentOsAccount(callback: AsyncCallback): void

查詢當前進程所屬的系統帳號的信息，使用callback回調異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.queryCurrentOsAccount((err, curAccountInfo)= >{
  console.log("queryCurrentOsAccount err:" + JSON.stringify(err));
  console.log("queryCurrentOsAccount curAccountInfo:" + JSON.stringify(curAccountInfo));
});

queryCurrentOsAccount

queryCurrentOsAccount(): Promise

查詢當前進程所屬的系統帳號的信息，使用Promise方式異步返回結果。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.queryCurrentOsAccount().then((accountInfo) = > {
  console.log("queryCurrentOsAccount, accountInfo: " + JSON.stringify(accountInfo));
}).catch((err) = > {
  console.log("queryCurrentOsAccount err: "  + JSON.stringify(err));
});

queryOsAccountById

queryOsAccountById(localId: number, callback: AsyncCallback): void

查詢指定系統帳號的信息，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**查詢ID為100的系統帳號信息

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.queryOsAccountById(localId, (err, accountInfo)= >{
  console.log("queryOsAccountById err:" + JSON.stringify(err));
  console.log("queryOsAccountById accountInfo:" + JSON.stringify(accountInfo));
});

queryOsAccountById

queryOsAccountById(localId: number): Promise

查詢指定系統帳號的信息，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS 或 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**查詢ID為100的系統帳號信息

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.queryOsAccountById(localId).then((accountInfo) = > {
  console.log("queryOsAccountById, accountInfo: " + JSON.stringify(accountInfo));
}).catch((err) = > {
  console.log("queryOsAccountById err: "  + JSON.stringify(err));
});

getOsAccountTypeFromProcess

getOsAccountTypeFromProcess(callback: AsyncCallback): void

查詢當前進程所屬的系統帳號的帳號類型，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountTypeFromProcess((err, accountType) = > {
  console.log("getOsAccountTypeFromProcess err: " + JSON.stringify(err));
  console.log('getOsAccountTypeFromProcess accountType: ' + accountType);
});

getOsAccountTypeFromProcess

getOsAccountTypeFromProcess(): Promise

查詢當前進程所屬的系統帳號的帳號類型，使用Promise方式異步返回結果。

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.getOsAccountTypeFromProcess().then((accountType) = > {
  console.log('getOsAccountTypeFromProcess, accountType: ' + accountType);
}).catch((err) = > {
  console.log("getOsAccountTypeFromProcess err: "  + JSON.stringify(err));
});

getDistributedVirtualDeviceId

getDistributedVirtualDeviceId(callback: AsyncCallback): void

獲取分布式虛擬設備ID，使用callback回調異步返回結果。

需要權限： ohos.permission.DISTRIBUTED_DATASYNC 或 ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.getDistributedVirtualDeviceId((err, virtualID) = > {
  console.log("getDistributedVirtualDeviceId err: " + JSON.stringify(err));
  console.log('getDistributedVirtualDeviceId virtualID: ' + virtualID);
});

getDistributedVirtualDeviceId

getDistributedVirtualDeviceId(): Promise

獲取分布式虛擬設備ID，使用Promise方式異步返回結果。

需要權限： ohos.permission.DISTRIBUTED_DATASYNC 或 ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

返回值：

示例：

const accountManager = account_osAccount.getAccountManager();
accountManager.getDistributedVirtualDeviceId().then((virtualID) = > {
  console.log('getDistributedVirtualDeviceId, virtualID: ' + virtualID);
}).catch((err) = > {
  console.log("getDistributedVirtualDeviceId err: "  + JSON.stringify(err));
});

getOsAccountProfilePhoto

getOsAccountProfilePhoto(localId: number, callback: AsyncCallback): void

獲取指定系統帳號的頭像信息，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**獲取ID為100的系統帳號的頭像

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getOsAccountProfilePhoto(localId, (err, photo)= >{
  console.log("getOsAccountProfilePhoto err:" + JSON.stringify(err));
  console.log("get photo:" + photo + " by localId: " + localId);
});

getOsAccountProfilePhoto

getOsAccountProfilePhoto(localId: number): Promise

獲取指定系統帳號的頭像信息，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**獲取ID為100的系統帳號的頭像

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getOsAccountProfilePhoto(localId).then((photo) = > {
  console.log("getOsAccountProfilePhoto: " + photo);
}).catch((err) = > {
  console.log("getOsAccountProfilePhoto err: "  + JSON.stringify(err));
});

setOsAccountProfilePhoto

setOsAccountProfilePhoto(localId: number, photo: string, callback: AsyncCallback): void

為指定系統帳號設置頭像信息，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**給ID為100的系統帳號設置頭像

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
var photo = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAYAAAA/I0V3AAAAAXNSR0IArs4c6QAAAARnQU1BAA"+
"Cxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACwSURBVDhPvZLBDYMwDEV/ugsXRjAT0EHCOuFIBwkbdIRewi6unbiAyoGgSn1SFH85+Y"+
"q/4ljARW62X+LHS8uIzjm4dXUYF+utzBikB52Jo5e5iEPKqpACk7R9NM2RvWm5tIkD2czLCUFNKLD6IjdMHFHDzws285MgGrT0xCtp3WOKHo"+
"+7q0mP0DZW9pNmoEFUzrQjp5cCnaen2kSJXLFD8ghbXyZCMQf/8e8Ns1XVAG/XAgqKzVnJFAAAAABJRU5ErkJggg=="
osAccountManager.setOsAccountProfilePhoto(localId, photo, (err)= >{
  console.log("setOsAccountProfilePhoto err:" + JSON.stringify(err));
});

setOsAccountProfilePhoto

setOsAccountProfilePhoto(localId: number, photo: string): Promise

為指定系統帳號設置頭像信息，使用Promise方式異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.MANAGE_LOCAL_ACCOUNTS

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**給ID為100的系統帳號設置頭像

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
var photo = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAA0AAAAPCAYAAAA/I0V3AAAAAXNSR0IArs4c6QAAAARnQU1BAA"+
"Cxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACwSURBVDhPvZLBDYMwDEV/ugsXRjAT0EHCOuFIBwkbdIRewi6unbiAyoGgSn1SFH85+Y"+
"q/4ljARW62X+LHS8uIzjm4dXUYF+utzBikB52Jo5e5iEPKqpACk7R9NM2RvWm5tIkD2czLCUFNKLD6IjdMHFHDzws285MgGrT0xCtp3WOKHo"+
"+7q0mP0DZW9pNmoEFUzrQjp5cCnaen2kSJXLFD8ghbXyZCMQf/8e8Ns1XVAG/XAgqKzVnJFAAAAABJRU5ErkJggg=="
accountManager.setOsAccountProfilePhoto(localId, photo).then(() = > {
  console.log("setOsAccountProfilePhoto success");
}).catch((err) = > {
  console.log("setOsAccountProfilePhoto err: "  + JSON.stringify(err));
});

getOsAccountLocalIdBySerialNumber8+

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

通過SN碼查詢與其關聯的系統帳號的帳號ID，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**查詢與SN碼12345關聯的系統帳號的ID

const accountManager = account_osAccount.getAccountManager();
var serialNumber = 12345;
accountManager.getOsAccountLocalIdBySerialNumber(serialNumber, (err, localId)= >{
  console.log("ger localId err:" + JSON.stringify(err));
  console.log("get localId:" + localId + " by serialNumber: " + serialNumber);
});

getOsAccountLocalIdBySerialNumber8+

getOsAccountLocalIdBySerialNumber(serialNumber: number): Promise

通過SN碼查詢與其關聯的系統帳號的帳號ID，使用Promise方式異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**查詢與SN碼12345關聯的系統帳號的ID

const accountManager = account_osAccount.getAccountManager();
var serialNumber = 12345;
accountManager.getOsAccountLocalIdBySerialNumber(serialNumber).then((localId) = > {
  console.log("getOsAccountLocalIdBySerialNumber localId: " + localId);
}).catch((err) = > {
  console.log("getOsAccountLocalIdBySerialNumber err: "  + JSON.stringify(err));
});

getSerialNumberByOsAccountLocalId8+

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

通過系統帳號ID獲取與該系統帳號關聯的SN碼，使用callback回調異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

**示例：**獲取ID為100的系統帳號關聯的SN碼

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getSerialNumberByOsAccountLocalId(localId, (err, serialNumber)= >{
  console.log("ger serialNumber err:" + JSON.stringify(err));
  console.log("get serialNumber:" + serialNumber + " by localId: " + localId);
});

getSerialNumberByOsAccountLocalId8+

getSerialNumberByOsAccountLocalId(localId: number): Promise

通過系統帳號ID獲取與該系統帳號關聯的SN碼，使用Promise方式異步返回結果。

系統能力： SystemCapability.Account.OsAccount

參數：

返回值：

**示例：**獲取ID為100的系統帳號關聯的SN碼

const accountManager = account_osAccount.getAccountManager();
var localId = 100;
accountManager.getSerialNumberByOsAccountLocalId(localId).then((serialNumber) = > {
  console.log("getSerialNumberByOsAccountLocalId serialNumber: " + serialNumber);
}).catch((err) = > {
  console.log("getSerialNumberByOsAccountLocalId err: "  + JSON.stringify(err));
});

on

on(type: 'activate' | 'activating', name: string, callback: Callback): void

訂閱系統帳號的變動信息，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
function onCallback(receiveLocalId){
  console.log("receive localId:" + receiveLocalId);
}
accountManager.on("activating", "osAccountOnOffNameA", onCallback);

off

off(type: 'activate' | 'activating', name: string, callback?: Callback): void

取消訂閱系統帳號的變動信息，使用callback回調異步返回結果。

此接口為系統接口，三方應用不支持調用。

需要權限： ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS_EXTENSION

系統能力： SystemCapability.Account.OsAccount

參數：

示例：

const accountManager = account_osAccount.getAccountManager();
function offCallback(){
  console.log("off enter")
}
accountManager.off("activating", "osAccountOnOffNameA", offCallback);

OsAccountInfo

系統帳號信息。

系統能力： 以下各項對應的系統能力均為SystemCapability.Account.OsAccount。

DomainAccountInfo8+

域帳號信息。

系統能力： 以下各項對應的系統能力均為SystemCapability.Account.OsAccount。

系統帳號約束列表

審核編輯 黃宇