harmony(鸿蒙)Device Settings Management

2022-10-28
浏览 (468)

Device Settings Management

The EnterpriseDeviceManager module provides capabilities to manage device settings, such as time settings. The APIs of this module can only be called by enterprise device administrator applications.

NOTE

The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Usage

Before calling any API in EnterpriseDeviceManager, use getDeviceSettingsManager to create an EnterpriseDeviceManager instance.

import enterpriseDeviceManager from '@ohos.enterpriseDeviceManager'

enterpriseDeviceManager.getDeviceSettingsManager((error, mgr) => {
    if (error) {
        console.log("error code:" + error.code + " error message:" + error.message);
        return;
    }
    let deviceMgr = mgr;
});

DeviceSettingsManager.setDateTime

setDateTime(admin: Want, time: number, callback: AsyncCallback<void>): void

Sets the system time. This API uses an asynchronous callback to return the result.

Required permissions: ohos.permission.EDM_MANAGE_DATETIME

System capability: SystemCapability.Customization.EnterpriseDeviceManager

Parameters

Name	Type	Mandatory	Description
admin	Want	Yes	Device administrator application.
time	number	Yes	Timestamp (ms).
callback	AsyncCallback<void>	Yes	Callback used to the result. If the system time is set successfully, err is null; otherwise, err is an error object.

Example

import enterpriseDeviceManager from '@ohos.enterpriseDeviceManager'

let wantTemp = {
    bundleName: "bundleName",
    abilityName: "abilityName",
};
enterpriseDeviceManager.getDeviceSettingsManager((error, mgr) => {
    if (error) {
        console.log("error code:" + error.code + " error message:" + error.message);
        return;
    }
    mgr.setDateTime(wantTemp, 1526003846000, (error) => {
        if (error) {
            console.log("error code:" + error.code + " error message:" + error.message);
        }
    });
});

DeviceSettingsManager.setDateTime

setDateTime(admin: Want, time: number): Promise<void>

Sets the system time. This API uses a promise to return the result.

Required permissions: ohos.permission.EDM_MANAGE_DATETIME

System capability: SystemCapability.Customization.EnterpriseDeviceManager

Parameters

Name	Type	Mandatory	Description
admin	Want	Yes	Device administrator application.
time	number	Yes	Timestamp (ms).

Return value

Type	Description
Promise<void>	Promise that returns no value.

Example

import enterpriseDeviceManager from '@ohos.enterpriseDeviceManager'

let wantTemp = {
    bundleName: "bundleName",
    abilityName: "abilityName",
};
enterpriseDeviceManager.getDeviceSettingsManager().then((mgr) => {
    mgr.setDateTime(wantTemp, 1526003846000).then(() => {
    }).catch((error) => {
        console.log("error code:" + error.code + " error message:" + error.message);
    })
}).catch((error) => {
    console.log("error code:" + error.code + " error message:" + error.message);
})