@ohos.bluetooth.access (蓝牙access模块)（系统接口）

access模块提供了打开和关闭蓝牙、获取蓝牙状态的方法。

说明：

本模块首批接口从API version 10开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 当前页面仅包含本模块的系统接口，其他公开接口参见@ohos.bluetooth.access (蓝牙access模块)

导入模块

import access from '@ohos.bluetooth.access';

access.factoryReset¹¹⁺

factoryReset(callback: AsyncCallback<void>): void

恢复蓝牙出厂设置。

系统接口：此接口为系统接口。

需要权限：ohos.permission.ACCESS_BLUETOOTH 和 ohos.permission.MANAGE_BLUETOOTH

系统能力：SystemCapability.Communication.Bluetooth.Core。

参数：

错误码：

以下错误码的详细介绍请参见蓝牙服务子系统错误码。

示例：

import { AsyncCallback, BusinessError } from '@ohos.base';
try {
    access.factoryReset((err: BusinessError) => {
        if (err) {
            console.error("factoryReset error");
        }
    });
} catch (err) {
    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
}

access.factoryReset¹¹⁺

factoryReset(): Promise<void>

恢复蓝牙出厂设置。

系统接口：此接口为系统接口。

需要权限：ohos.permission.ACCESS_BLUETOOTH 和 ohos.permission.MANAGE_BLUETOOTH

系统能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

错误码：

以下错误码的详细介绍请参见蓝牙服务子系统错误码。

示例：

import { AsyncCallback, BusinessError } from '@ohos.base';
try {
    access.factoryReset().then(() => {
        console.info("factoryReset");
    });
} catch (err) {
    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
}

access.getLocalAddress¹¹⁺

getLocalAddress(): string;

获取本端设备的蓝牙地址。

系统接口：此接口为系统接口。

需要权限：ohos.permission.ACCESS_BLUETOOTH 和 ohos.permission.GET_BLUETOOTH_LOCAL_MAC

系统能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

错误码：

以下错误码的详细介绍请参见蓝牙服务子系统错误码。

示例：

try {
    let localAddr = access.getLocalAddress();
} catch (err) {
    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
}