@ohos.bluetooth.a2dp (Bluetooth A2DP Module)

The a2dp module provides APIs for using the Bluetooth Advanced Audio Distribution Profile (A2DP), which defines how to stream high quality audio from one device to another over a Bluetooth connection.

NOTE

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

Modules to Import

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

a2dp.createA2dpSrcProfile

createA2dpSrcProfile(): A2dpSourceProfile

Creates an A2dpSrcProfile instance.

System capability: SystemCapability.Communication.Bluetooth.Core

Return value

Example

import { BusinessError } from '@ohos.base';
try {
    let a2dpProfile = a2dp.createA2dpSrcProfile();
    console.info('a2dp success');
} catch (err) {
    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
}

A2dpSourceProfile

Provides APIs for using the A2DP. Before using any API of A2dpSourceProfile, you need to create an instance of this class by using createA2dpSrcProfile().

getPlayingState

getPlayingState(deviceId: string): PlayingState

Obtains the playing state of a device.

Required permissions: ohos.permission.ACCESS_BLUETOOTH

System capability: SystemCapability.Communication.Bluetooth.Core

Parameters

Return value

Error codes

For details about the error codes, see Bluetooth Error Codes.

Example

import { BusinessError } from '@ohos.base';
try {
    let a2dpSrc = a2dp.createA2dpSrcProfile();
    let state = a2dpSrc.getPlayingState('XX:XX:XX:XX:XX:XX');
} catch (err) {
    console.error('errCode: ' + (err as BusinessError).code + ', errMessage: ' + (err as BusinessError).message);
}

PlayingState

Enumerates the A2DP playing states.

System capability: SystemCapability.Communication.Bluetooth.Core

CodecInfo¹¹⁺

Defines the codec information.

System capability: SystemCapability.Communication.Bluetooth.Core

CodecType¹¹⁺

Enumerates the Bluetooth codec types.

System capability: SystemCapability.Communication.Bluetooth.Core

CodecChannelMode¹¹⁺

Enumerates the channel modes of the Bluetooth codec.

System capability: SystemCapability.Communication.Bluetooth.Core

CodecBitsPerSample¹¹⁺

Enumerates the number of bits per sample for the Bluetooth codec.

System capability: SystemCapability.Communication.Bluetooth.Core

CodecSampleRate¹¹⁺

Enumerates the sampling rates of the Bluetooth codec.

System capability: SystemCapability.Communication.Bluetooth.Core