藍(lán)牙

導(dǎo)入模塊

import bluetoothManager from '@ohos.bluetoothManager';

bluetoothManager.enableBluetooth

enableBluetooth(): void

開(kāi)啟藍(lán)牙。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    bluetoothManager.enableBluetooth();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.disableBluetooth

disableBluetooth(): void

關(guān)閉藍(lán)牙。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    bluetoothManager.disableBluetooth();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getLocalName

getLocalName(): string

獲取藍(lán)牙本地設(shè)備名稱。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let localName = bluetoothManager.getLocalName();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getState

getState(): BluetoothState

獲取藍(lán)牙開(kāi)關(guān)狀態(tài)。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let state = bluetoothManager.getState();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getBtConnectionState

getBtConnectionState(): ProfileConnectionState

獲取藍(lán)牙設(shè)備的Profile連接狀態(tài)。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let connectionState = bluetoothManager.getBtConnectionState();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.setLocalName

setLocalName(name: string): void

設(shè)置藍(lán)牙本地設(shè)備名稱。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    bluetoothManager.setLocalName('device_name');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.pairDevice

pairDevice(deviceId: string): void

發(fā)起藍(lán)牙配對(duì)。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    // 實(shí)際的地址可由掃描流程獲取
    bluetoothManager.pairDevice("XX:XX:XX:XX:XX:XX");
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getProfileConnectionState

getProfileConnectionState(profileId: ProfileId): ProfileConnectionState

獲取profile的連接狀態(tài)。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let result = bluetoothManager.getProfileConnectionState(bluetoothManager.ProfileId.PROFILE_A2DP_SOURCE);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getRemoteDeviceName

getRemoteDeviceName(deviceId: string): string

獲取對(duì)端藍(lán)牙設(shè)備的名稱。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let remoteDeviceName = bluetoothManager.getRemoteDeviceName("XX:XX:XX:XX:XX:XX");
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getRemoteDeviceClass

getRemoteDeviceClass(deviceId: string): DeviceClass

獲取對(duì)端藍(lán)牙設(shè)備的類別。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let remoteDeviceClass = bluetoothManager.getRemoteDeviceClass("XX:XX:XX:XX:XX:XX");
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getPairedDevices

getPairedDevices(): Array<string>

獲取藍(lán)牙配對(duì)列表。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let devices = bluetoothManager.getPairedDevices();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.setBluetoothScanMode

setBluetoothScanMode(mode: ScanMode, duration: number): void

設(shè)置藍(lán)牙掃描模式，可以被遠(yuǎn)端設(shè)備發(fā)現(xiàn)。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    // 設(shè)置為可連接可發(fā)現(xiàn)才可被遠(yuǎn)端設(shè)備掃描到，可以連接。
    bluetoothManager.setBluetoothScanMode(bluetoothManager.ScanMode.SCAN_MODE_CONNECTABLE_GENERAL_DISCOVERABLE, 100);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getBluetoothScanMode

getBluetoothScanMode(): ScanMode

獲取藍(lán)牙掃描模式。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let scanMode = bluetoothManager.getBluetoothScanMode();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.startBluetoothDiscovery

startBluetoothDiscovery(): void

開(kāi)啟藍(lán)牙掃描，可以發(fā)現(xiàn)遠(yuǎn)端設(shè)備。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let deviceId;
function onReceiveEvent(data) {
    deviceId = data;
}
try {
    bluetoothManager.on('bluetoothDeviceFind', onReceiveEvent);
    bluetoothManager.startBluetoothDiscovery();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.stopBluetoothDiscovery

stopBluetoothDiscovery(): void

關(guān)閉藍(lán)牙掃描。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    bluetoothManager.stopBluetoothDiscovery();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.setDevicePairingConfirmation

setDevicePairingConfirmation(device: string, accept: boolean): void

設(shè)置設(shè)備配對(duì)請(qǐng)求確認(rèn)。

需要權(quán)限：ohos.permission.MANAGE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    // 訂閱“pinRequired”配對(duì)請(qǐng)求事件，收到遠(yuǎn)端配對(duì)請(qǐng)求后設(shè)置配對(duì)確認(rèn)
    function onReceivePinRequiredEvent(data) { // data為配對(duì)請(qǐng)求的入?yún)ⅲ鋵?duì)請(qǐng)求參數(shù)
        console.info('pin required  = '+ JSON.stringify(data));
        bluetoothManager.setDevicePairingConfirmation(data.deviceId, true);
    }
    bluetoothManager.on("pinRequired", onReceivePinRequiredEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.on('bluetoothDeviceFind')

on(type: "bluetoothDeviceFind", callback: Callback<Array<string>>): void

訂閱藍(lán)牙設(shè)備發(fā)現(xiàn)上報(bào)事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) { // data為藍(lán)牙設(shè)備地址集合
    console.info('bluetooth device find = '+ JSON.stringify(data));
}
try {
    bluetoothManager.on('bluetoothDeviceFind', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.off('bluetoothDeviceFind')

off(type: "bluetoothDeviceFind", callback?: Callback<Array<string>>): void

取消訂閱藍(lán)牙設(shè)備發(fā)現(xiàn)上報(bào)事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) {
    console.info('bluetooth device find = '+ JSON.stringify(data));
}
try {
    bluetoothManager.on('bluetoothDeviceFind', onReceiveEvent);
    bluetoothManager.off('bluetoothDeviceFind', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.on('pinRequired')

on(type: "pinRequired", callback: Callback<PinRequiredParam>): void

訂閱遠(yuǎn)端藍(lán)牙設(shè)備的配對(duì)請(qǐng)求事件。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) { // data為配對(duì)請(qǐng)求參數(shù)
    console.info('pin required = '+ JSON.stringify(data));
}
try {
    bluetoothManager.on('pinRequired', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.off('pinRequired')

off(type: "pinRequired", callback?: Callback<PinRequiredParam>): void

取消訂閱遠(yuǎn)端藍(lán)牙設(shè)備的配對(duì)請(qǐng)求事件。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) {
    console.info('pin required = '+ JSON.stringify(data));
}
try {
    bluetoothManager.on('pinRequired', onReceiveEvent);
    bluetoothManager.off('pinRequired', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.on('bondStateChange')

on(type: "bondStateChange", callback: Callback<BondStateParam>): void

訂閱藍(lán)牙配對(duì)狀態(tài)改變事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) { // data為回調(diào)函數(shù)入?yún)?，表示配?duì)的狀態(tài)
    console.info('pair state = '+ JSON.stringify(data));
}
try {
    bluetoothManager.on('bondStateChange', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.off('bondStateChange')

off(type: "bondStateChange", callback?: Callback<BondStateParam>): void

取消訂閱藍(lán)牙配對(duì)狀態(tài)改變事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) {
    console.info('bond state = '+ JSON.stringify(data));
}
try {
    bluetoothManager.on('bondStateChange', onReceiveEvent);
    bluetoothManager.off('bondStateChange', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.on('stateChange')

on(type: "stateChange", callback: Callback<BluetoothState>): void

訂閱藍(lán)牙連接狀態(tài)改變事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) {
    console.info('bluetooth state = '+ JSON.stringify(data));
}
try {
    bluetoothManager.on('stateChange', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.off('stateChange')

off(type: "stateChange", callback?: Callback<BluetoothState>): void

取消訂閱藍(lán)牙連接狀態(tài)改變事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) {
    console.info('bluetooth state = '+ JSON.stringify(data));
}
try {
    bluetoothManager.on('stateChange', onReceiveEvent);
    bluetoothManager.off('stateChange', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.sppListen

sppListen(name: string, option: SppOption, callback: AsyncCallback<number>): void

創(chuàng)建一個(gè)服務(wù)端監(jiān)聽(tīng)Socket。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let serverNumber = -1;
function serverSocket(code, number) {
  console.log('bluetooth error code: ' + code.code);
  if (code.code == 0) {
    console.log('bluetooth serverSocket Number: ' + number);
    serverNumber = number;
  }
}

let sppOption = {uuid: '00001810-0000-1000-8000-00805F9B34FB', secure: false, type: 0};
try {
    bluetoothManager.sppListen('server1', sppOption, serverSocket);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.sppAccept

sppAccept(serverSocket: number, callback: AsyncCallback<number>): void

服務(wù)端監(jiān)聽(tīng)socket等待客戶端連接。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let serverNumber = -1;
function serverSocket(code, number) {
  console.log('bluetooth error code: ' + code.code);
  if (code.code == 0) {
    console.log('bluetooth serverSocket Number: ' + number);
    serverNumber = number;
  }
}
let clientNumber = -1;
function acceptClientSocket(code, number) {
  console.log('bluetooth error code: ' + code.code);
  if (code.code == 0) {
    console.log('bluetooth clientSocket Number: ' + number);
    // 獲取的clientNumber用作服務(wù)端后續(xù)讀/寫(xiě)操作socket的id。
    clientNumber = number;
  }
}
try {
    bluetoothManager.sppAccept(serverNumber, acceptClientSocket);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.sppConnect

sppConnect(device: string, option: SppOption, callback: AsyncCallback<number>): void

客戶端向遠(yuǎn)端設(shè)備發(fā)起spp連接。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let clientNumber = -1;
function clientSocket(code, number) {
  if (code.code != 0) {
    return;
  }
  console.log('bluetooth serverSocket Number: ' + number);
  // 獲取的clientNumber用作客戶端后續(xù)讀/寫(xiě)操作socket的id。
  clientNumber = number;
}
let sppOption = {uuid: '00001810-0000-1000-8000-00805F9B34FB', secure: false, type: 0};
try {
    bluetoothManager.sppConnect('XX:XX:XX:XX:XX:XX', sppOption, clientSocket);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.sppCloseServerSocket

sppCloseServerSocket(socket: number): void

關(guān)閉服務(wù)端監(jiān)聽(tīng)Socket，入?yún)ocket由sppListen接口返回。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let serverNumber = -1;
function serverSocket(code, number) {
  console.log('bluetooth error code: ' + code.code);
  if (code.code == 0) {
    console.log('bluetooth serverSocket Number: ' + number);
    serverNumber = number;
  }
}
try {
    bluetoothManager.sppCloseServerSocket(serverNumber);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.sppCloseClientSocket

sppCloseClientSocket(socket: number): void

關(guān)閉客戶端socket，入?yún)ocket由sppAccept或sppConnect接口獲取。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let clientNumber = -1;
function clientSocket(code, number) {
  if (code.code != 0) {
    return;
  }
  console.log('bluetooth serverSocket Number: ' + number);
  // 獲取的clientNumber用作客戶端后續(xù)讀/寫(xiě)操作socket的id。
  clientNumber = number;
}
try {
    bluetoothManager.sppCloseClientSocket(clientNumber);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.sppWrite

sppWrite(clientSocket: number, data: ArrayBuffer): void

通過(guò)socket向遠(yuǎn)端發(fā)送數(shù)據(jù)，入?yún)lientSocket由sppAccept或sppConnect接口獲取 。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let clientNumber = -1;
function clientSocket(code, number) {
  if (code.code != 0) {
    return;
  }
  console.log('bluetooth serverSocket Number: ' + number);
  // 獲取的clientNumber用作客戶端后續(xù)讀/寫(xiě)操作socket的id。
  clientNumber = number;
}
let arrayBuffer = new ArrayBuffer(8);
let data = new Uint8Array(arrayBuffer);
data[0] = 123;
try {
    bluetoothManager.sppWrite(clientNumber, arrayBuffer);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.on('sppRead')

on(type: "sppRead", clientSocket: number, callback: Callback<ArrayBuffer>): void

訂閱spp讀請(qǐng)求事件，入?yún)lientSocket由sppAccept或sppConnect接口獲取。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let clientNumber = -1;
function clientSocket(code, number) {
  if (code.code != 0) {
    return;
  }
  console.log('bluetooth serverSocket Number: ' + number);
  // 獲取的clientNumber用作客戶端后續(xù)讀/寫(xiě)操作socket的id。
  clientNumber = number;
}
function dataRead(dataBuffer) {
  let data = new Uint8Array(dataBuffer);
  console.log('bluetooth data is: ' + data[0]);
}
try {
    bluetoothManager.on('sppRead', clientNumber, dataRead);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.off('sppRead')

off(type: "sppRead", clientSocket: number, callback?: Callback<ArrayBuffer>): void

取消訂閱spp讀請(qǐng)求事件，入?yún)lientSocket由sppAccept或sppConnect接口獲取。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

示例：

let clientNumber = -1;
function clientSocket(code, number) {
  if (code.code != 0) {
    return;
  }
  console.log('bluetooth serverSocket Number: ' + number);
  // 獲取的clientNumber用作客戶端后續(xù)讀/寫(xiě)操作socket的id。
  clientNumber = number;
}
try {
    bluetoothManager.off('sppRead', clientNumber);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.getProfileInstance

getProfileInstance(profileId: ProfileId): A2dpSourceProfile | HandsFreeAudioGatewayProfile | HidHostProfile | PanProfile

通過(guò)ProfileId，獲取profile的對(duì)象實(shí)例，API9新增了HidHostProfile，PanProfile。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

示例：

try {
    let hidHost = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_HID_HOST);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.BLE

bluetoothManager.BLE.createGattServer

createGattServer(): GattServer

創(chuàng)建一個(gè)可使用的GattServer實(shí)例。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

示例：

let gattServer = bluetoothManager.BLE.createGattServer();

bluetoothManager.BLE.createGattClientDevice

createGattClientDevice(deviceId: string): GattClientDevice

創(chuàng)建一個(gè)可使用的GattClientDevice實(shí)例。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

示例：

try {
    let device = bluetoothManager.BLE.createGattClientDevice('XX:XX:XX:XX:XX:XX');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.BLE.getConnectedBLEDevices

getConnectedBLEDevices(): Array<string>

獲取和當(dāng)前設(shè)備連接的BLE設(shè)備。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let result = bluetoothManager.BLE.getConnectedBLEDevices();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.BLE.startBLEScan

startBLEScan(filters: Array<ScanFilter>, options?: ScanOptions): void

發(fā)起B(yǎng)LE掃描流程。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH 和 ohos.permission.MANAGE_BLUETOOTH 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) {
    console.info('BLE scan device find result = '+ JSON.stringify(data));
}
try {
    bluetoothManager.BLE.on("BLEDeviceFind", onReceiveEvent);
    bluetoothManager.BLE.startBLEScan(
        [{
            deviceId:"XX:XX:XX:XX:XX:XX",
            name:"test",
            serviceUuid:"00001888-0000-1000-8000-00805f9b34fb"
        }],
        {
            interval: 500,
            dutyMode: bluetoothManager.ScanDuty.SCAN_MODE_LOW_POWER,
            matchMode: bluetoothManager.MatchMode.MATCH_MODE_AGGRESSIVE,
        }
    );
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.BLE.stopBLEScan

stopBLEScan(): void

停止BLE掃描流程。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    bluetoothManager.BLE.stopBLEScan();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.BLE.on('BLEDeviceFind')

on(type: "BLEDeviceFind", callback: Callback<Array<ScanResult>>): void

訂閱BLE設(shè)備發(fā)現(xiàn)上報(bào)事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) {
    console.info('bluetooth device find = '+ JSON.stringify(data));
}
try {
    bluetoothManager.BLE.on('BLEDeviceFind', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

bluetoothManager.BLE.off('BLEDeviceFind')

off(type: "BLEDeviceFind", callback?: Callback<Array<ScanResult>>): void

取消訂閱BLE設(shè)備發(fā)現(xiàn)上報(bào)事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

function onReceiveEvent(data) {
    console.info('bluetooth device find = '+ JSON.stringify(data));
}
try {
    bluetoothManager.BLE.on('BLEDeviceFind', onReceiveEvent);
    bluetoothManager.BLE.off('BLEDeviceFind', onReceiveEvent);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

BaseProfile

profile基類。

getConnectionDevices

getConnectionDevices(): Array<string>

獲取已連接設(shè)備列表。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let a2dpSrc = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_A2DP_SOURCE) as bluetoothManager.A2dpSourceProfile;
    let retArray = a2dpSrc.getConnectionDevices();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

getDeviceState

getDeviceState(device: string): ProfileConnectionState

獲取設(shè)備profile的連接狀態(tài)。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let a2dpSrc = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_A2DP_SOURCE) as bluetoothManager.A2dpSourceProfile;
    let ret = a2dpSrc.getDeviceState('XX:XX:XX:XX:XX:XX');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

A2dpSourceProfile

使用A2dpSourceProfile方法之前需要?jiǎng)?chuàng)建該類的實(shí)例進(jìn)行操作，通過(guò)getProfile()方法構(gòu)造此實(shí)例。

connect

connect(device: string): void

發(fā)起設(shè)備的A2dp服務(wù)連接請(qǐng)求。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let a2dpSrc = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_A2DP_SOURCE) as bluetoothManager.A2dpSourceProfile;
    a2dpSrc.connect('XX:XX:XX:XX:XX:XX');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

disconnect

disconnect(device: string): void

斷開(kāi)設(shè)備的a2dp服務(wù)連接。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let a2dpSrc = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_A2DP_SOURCE) as bluetoothManager.A2dpSourceProfile;
    a2dpSrc.disconnect('XX:XX:XX:XX:XX:XX');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

on('connectionStateChange')

on(type: "connectionStateChange", callback: Callback<StateChangeParam>): void

訂閱a2dp連接狀態(tài)變化事件。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

無(wú)

示例：

function onReceiveEvent(data) {
    console.info('a2dp state = '+ JSON.stringify(data));
}
let a2dpSrc = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_A2DP_SOURCE) as bluetoothManager.A2dpSourceProfile;
a2dpSrc.on('connectionStateChange', onReceiveEvent);

off('connectionStateChange')

off(type: "connectionStateChange", callback?: Callback<StateChangeParam>): void

取消訂閱a2dp連接狀態(tài)變化事件。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

無(wú)

示例：

function onReceiveEvent(data) {
    console.info('a2dp state = '+ JSON.stringify(data));
}
let a2dpSrc = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_A2DP_SOURCE) as bluetoothManager.A2dpSourceProfile;
a2dpSrc.on('connectionStateChange', onReceiveEvent);
a2dpSrc.off('connectionStateChange', onReceiveEvent);

getPlayingState

getPlayingState(device: string): PlayingState

獲取設(shè)備的播放狀態(tài)。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

返回值：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let a2dpSrc = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_A2DP_SOURCE) as bluetoothManager.A2dpSourceProfile;
    let state = a2dpSrc.getPlayingState('XX:XX:XX:XX:XX:XX');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

HandsFreeAudioGatewayProfile

使用HandsFreeAudioGatewayProfile方法之前需要?jiǎng)?chuàng)建該類的實(shí)例進(jìn)行操作，通過(guò)getProfile()方法構(gòu)造此實(shí)例。

connect

connect(device: string): void

連接設(shè)備的HFP服務(wù)。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let hfpAg = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_HANDS_FREE_AUDIO_GATEWAY) as bluetoothManager.HandsFreeAudioGatewayProfile;
    hfpAg.connect('XX:XX:XX:XX:XX:XX');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

disconnect

disconnect(device: string): void

斷開(kāi)連接設(shè)備的HFP服務(wù)。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

try {
    let hfpAg = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_HANDS_FREE_AUDIO_GATEWAY) as bluetoothManager.HandsFreeAudioGatewayProfile;
    hfpAg.disconnect('XX:XX:XX:XX:XX:XX');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

on('connectionStateChange')

on(type: "connectionStateChange", callback: Callback<StateChangeParam>): void

訂閱HFP連接狀態(tài)變化事件。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

示例：

function onReceiveEvent(data) {
    console.info('hfp state = '+ JSON.stringify(data));
}
let hfpAg = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_HANDS_FREE_AUDIO_GATEWAY) as
  bluetoothManager.HandsFreeAudioGatewayProfile;
hfpAg.on('connectionStateChange', onReceiveEvent);

off('connectionStateChange')

off(type: "connectionStateChange", callback?: Callback<StateChangeParam>): void

取消訂閱HFP連接狀態(tài)變化事件。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

示例：

function onReceiveEvent(data) {
    console.info('hfp state = '+ JSON.stringify(data));
}
let hfpAg = bluetoothManager.getProfileInstance(bluetoothManager.ProfileId.PROFILE_HANDS_FREE_AUDIO_GATEWAY) as
  bluetoothManager.HandsFreeAudioGatewayProfile;
hfpAg.on('connectionStateChange', onReceiveEvent);
hfpAg.off('connectionStateChange', onReceiveEvent);

HidHostProfile

使用HidHostProfile方法之前需要?jiǎng)?chuàng)建該類的實(shí)例進(jìn)行操作，通過(guò)getProfile()方法構(gòu)造此實(shí)例。

on('connectionStateChange')

on(type: "connectionStateChange", callback: Callback<StateChangeParam>): void

訂閱HidHost連接狀態(tài)變化事件。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

示例：

function onReceiveEvent(data) {
    console.info('hidHost state = '+ JSON.stringify(data));
}
let hidHost = bluetoothManager.getProfileInst(bluetoothManager.ProfileId.PROFILE_HID_HOST) as bluetoothManager.HidHostProfile;
hidHost.on('connectionStateChange', onReceiveEvent);

off('connectionStateChange')

off(type: "connectionStateChange", callback?: Callback<StateChangeParam>): void

取消訂閱HidHost連接狀態(tài)變化事件。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

示例：

function onReceiveEvent(data) {
    console.info('hidHost state = '+ JSON.stringify(data));
}
let hidHost = bluetoothManager.getProfileInst(bluetoothManager.ProfileId.PROFILE_HID_HOST) as bluetoothManager.HidHostProfile;
hidHost.on('connectionStateChange', onReceiveEvent);
hidHost.off('connectionStateChange', onReceiveEvent);

PanProfile

使用PanProfile方法之前需要?jiǎng)?chuàng)建該類的實(shí)例進(jìn)行操作，通過(guò)getProfile()方法構(gòu)造此實(shí)例。

on('connectionStateChange')

on(type: "connectionStateChange", callback: Callback<StateChangeParam>): void

訂閱Pan連接狀態(tài)變化事件。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

示例：

function onReceiveEvent(data) {
    console.info('pan state = '+ JSON.stringify(data));
}
let panProfile = bluetoothManager.getProfileInst(bluetoothManager.ProfileId.PROFILE_PAN_NETWORK) as bluetoothManager.PanProfile;
panProfile.on('connectionStateChange', onReceiveEvent);

off('connectionStateChange')

off(type: "connectionStateChange", callback?: Callback<StateChangeParam>): void

取消訂閱Pan連接狀態(tài)變化事件。

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

示例：

function onReceiveEvent(data) {
    console.info('pan state = '+ JSON.stringify(data));
}
let panProfile = bluetoothManager.getProfileInst(bluetoothManager.ProfileId.PROFILE_PAN_NETWORK) as bluetoothManager.PanProfile;
panProfile.on('connectionStateChange', onReceiveEvent);
panProfile.off('connectionStateChange', onReceiveEvent);

GattServer

server端類，使用server端方法之前需要?jiǎng)?chuàng)建該類的實(shí)例進(jìn)行操作，通過(guò)createGattServer()方法構(gòu)造此實(shí)例。

startAdvertising

startAdvertising(setting: AdvertiseSetting, advData: AdvertiseData, advResponse?: AdvertiseData): void

開(kāi)始發(fā)送BLE廣播。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let manufactureValueBuffer = new Uint8Array(4);
manufactureValueBuffer[0] = 1;
manufactureValueBuffer[1] = 2;
manufactureValueBuffer[2] = 3;
manufactureValueBuffer[3] = 4;

let serviceValueBuffer = new Uint8Array(4);
serviceValueBuffer[0] = 4;
serviceValueBuffer[1] = 6;
serviceValueBuffer[2] = 7;
serviceValueBuffer[3] = 8;
console.info('manufactureValueBuffer = '+ JSON.stringify(manufactureValueBuffer));
console.info('serviceValueBuffer = '+ JSON.stringify(serviceValueBuffer));
let gattServer = bluetoothManager.BLE.createGattServer();
try {
    gattServer.startAdvertising({
            interval:150,
            txPower:60,
            connectable:true,
        },{
            serviceUuids:["00001888-0000-1000-8000-00805f9b34fb"],
            manufactureData:[{
                 manufactureId:4567,
                 manufactureValue:manufactureValueBuffer.buffer
            }],
            serviceData:[{
                serviceUuid:"00001888-0000-1000-8000-00805f9b34fb",
                serviceValue:serviceValueBuffer.buffer
            }],
        },{
            serviceUuids:["00001889-0000-1000-8000-00805f9b34fb"],
            manufactureData:[{
                manufactureId:1789,
                manufactureValue:manufactureValueBuffer.buffer
            }],
            serviceData:[{
                serviceUuid:"00001889-0000-1000-8000-00805f9b34fb",
                serviceValue:serviceValueBuffer.buffer
            }],
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

stopAdvertising

stopAdvertising(): void

停止發(fā)送BLE廣播。

需要權(quán)限：ohos.permission.DISCOVER_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let server = bluetoothManager.BLE.createGattServer();
try {
    server.stopAdvertising();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

addService

addService(service: GattService): void

server端添加服務(wù)。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

// 創(chuàng)建descriptors
let descriptors = [];
let arrayBuffer = new ArrayBuffer(8);
let descV = new Uint8Array(arrayBuffer);
descV[0] = 11;
let descriptor = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
  characteristicUuid: '00001820-0000-1000-8000-00805F9B34FB',
  descriptorUuid: '00002902-0000-1000-8000-00805F9B34FB', descriptorValue: arrayBuffer};
descriptors[0] = descriptor;

// 創(chuàng)建characteristics
let characteristics = [];
let arrayBufferC = new ArrayBuffer(8);
let cccV = new Uint8Array(arrayBufferC);
cccV[0] = 1;
let characteristic = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
  characteristicUuid: '00001820-0000-1000-8000-00805F9B34FB', characteristicValue: arrayBufferC, descriptors:descriptors};
let characteristicN = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
  characteristicUuid: '00001821-0000-1000-8000-00805F9B34FB', characteristicValue: arrayBufferC, descriptors:descriptors};
characteristics[0] = characteristic;

// 創(chuàng)建gattService
let gattService = {serviceUuid:'00001810-0000-1000-8000-00805F9B34FB', isPrimary: true, characteristics:characteristics, includeServices:[]};

let gattServer = bluetoothManager.BLE.createGattServer();
try {
    gattServer.addService(gattService);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

removeService

removeService(serviceUuid: string): void

刪除已添加的服務(wù)。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let server = bluetoothManager.BLE.createGattServer();
try {
    server.removeService('00001810-0000-1000-8000-00805F9B34FB');
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

close

close(): void

關(guān)閉服務(wù)端功能，去注冊(cè)server在協(xié)議棧的注冊(cè)，調(diào)用該接口后GattServer實(shí)例將不能再使用。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

let server = bluetoothManager.BLE.createGattServer();
try {
    server.close();
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

notifyCharacteristicChanged

notifyCharacteristicChanged(deviceId: string, notifyCharacteristic: NotifyCharacteristic): void

server端特征值發(fā)生變化時(shí)，主動(dòng)通知已連接的client設(shè)備。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

// 創(chuàng)建descriptors
let descriptors = [];
let arrayBuffer = new ArrayBuffer(8);
let descV = new Uint8Array(arrayBuffer);
descV[0] = 11;
let descriptor = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
  characteristicUuid: '00001820-0000-1000-8000-00805F9B34FB',
  descriptorUuid: '00002902-0000-1000-8000-00805F9B34FB', descriptorValue: arrayBuffer};
descriptors[0] = descriptor;
let arrayBufferC = new ArrayBuffer(8);
let characteristic = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
  characteristicUuid: '00001820-0000-1000-8000-00805F9B34FB', characteristicValue: arrayBufferC, descriptors:descriptors};
let notifyCharacteristic = {serviceUuid: '00001810-0000-1000-8000-00805F9B34FB',
  characteristicUuid: '00001821-0000-1000-8000-00805F9B34FB', characteristicValue: characteristic.characteristicValue, confirm: false};
let server = bluetoothManager.BLE.createGattServer();
try {
    server.notifyCharacteristicChanged('XX:XX:XX:XX:XX:XX', notifyCharacteristic);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

sendResponse

sendResponse(serverResponse: ServerResponse): void

server端回復(fù)client端的讀寫(xiě)請(qǐng)求。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見(jiàn)藍(lán)牙服務(wù)子系統(tǒng)錯(cuò)誤碼。

示例：

/* send response */
let arrayBufferCCC = new ArrayBuffer(8);
let cccValue = new Uint8Array(arrayBufferCCC);
cccValue[0] = 1123;
let serverResponse = {
    "deviceId": "XX:XX:XX:XX:XX:XX",
    "transId": 0,
    "status": 0,
    "offset": 0,
    "value": arrayBufferCCC,
};

let gattServer = bluetoothManager.BLE.createGattServer();
try {
    gattServer.sendResponse(serverResponse);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

on('characteristicRead')

on(type: "characteristicRead", callback: Callback<CharacteristicReadRequest>): void

server端訂閱特征值讀請(qǐng)求事件。

需要權(quán)限：ohos.permission.USE_BLUETOOTH

系統(tǒng)能力：SystemCapability.Communication.Bluetooth.Core。

參數(shù)：

示例：

let arrayBufferCCC = new ArrayBuffer(8);
let cccValue = new Uint8Array(arrayBufferCCC);
cccValue[0] = 1123;
function ReadCharacteristicReq(CharacteristicReadRequest) {
    let deviceId = CharacteristicReadRequest.deviceId;
    let transId = CharacteristicReadRequest.transId;
    let offset = CharacteristicReadRequest.offset;
    let characteristicUuid = CharacteristicReadRequest.characteristicUuid;

    let serverResponse = {deviceId: deviceId, transId: transId, status: 0, offset: offset, value:arrayBufferCCC};

    try {
        gattServer.sendResponse(serverResponse);
    } catch (err) {
        console.error("errCode:" + err.code + ",errMessage:" + err.message);
    }
}

let gattServer = bluetoothManager.BLE.createGattServer();
gattServer.on("characteristicRead", ReadCharacteristicReq);