harmony(鸿蒙)设备设置管理

  • 2022-10-28
  • 浏览 (712)

设备设置管理

本模块提供设备设置管理能力,包括设置时间等。仅企业设备管理员应用才能调用。

说明

本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

使用说明

通过enterpriseDeviceManager中getDeviceSettingsManager方法获取。

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

设置系统时间。使用callback异步回调。

需要权限: ohos.permission.ENTERPRISE_SET_DATETIME

系统能力: SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

参数:

参数名 类型 必填 说明
admin Want 设备管理员应用。
time number 时间戳(ms)。
callback AsyncCallback<void> 回调函数。当系统时间设置成功err为null,否则为错误对象。

错误码

以下的错误码的详细介绍请参见企业设备管理错误码

类型 说明
9200001 The application is not a administrator of the device.
9200002 The administrator application does not have permission to manage the device.

示例:

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>

设置系统时间。使用Promise异步回调。

需要权限: ohos.permission.ENTERPRISE_SET_DATETIME

系统能力: SystemCapability.Customization.EnterpriseDeviceManager

系统API: 此接口为系统接口。

参数:

参数名 类型 必填 说明
admin Want 设备管理员应用。
time number 时间戳(ms)。

返回值:

类型 说明
Promise<void> Promise对象。无返回结果的Promise对象。

错误码

以下的错误码的详细介绍请参见企业设备管理错误码

类型 说明
9200001 The application is not a administrator of the device.
9200002 The administrator application does not have permission to manage the device.

示例:

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);
})

你可能感兴趣的鸿蒙文章

harmony(鸿蒙)接口

harmony(鸿蒙)开发说明

harmony(鸿蒙)BundleStatusCallback

harmony(鸿蒙)innerBundleManager模块(JS端SDK接口)

harmony(鸿蒙)distributedBundle模块(JS端SDK接口)

harmony(鸿蒙)Bundle模块(JS端SDK接口)

harmony(鸿蒙)Context模块

harmony(鸿蒙)DataUriUtils模块

harmony(鸿蒙)EnterpriseAdminExtensionAbility

harmony(鸿蒙)延迟任务调度回调

0  赞