> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 执行蓝牙 A2DP sink 功能

> 您可以使用 ``bluetoothctl`` 菜单、``menu transport`` 子菜单和 ``menu player`` 子菜单执行蓝牙 A2DP sink 功能。蓝牙 A2DP sink 功能包括连接或断开远程设备，以及列出音频流可用的传输选项。它们允许您检索编解码器能力信息、设置绝对音量以及播放音频文件。您可以使用播放控制功能在播放期间暂停、停止、播放下一个或上一个音频文件以及快进。

## 前提条件

开始之前，请按照 <a href="verify-a2-dp-functions#set-up-the-device-for-a2dp-functions" target="_self">为 A2DP 功能设置设备</a> 中的说明设置您的设备并进入所需的菜单。

## 连接远程设备

要连接远程设备，请在 `bluetoothctl` 菜单中运行以下命令：

```text theme={null}
connect <bt_address>
```

**参数**

`<bt_address>` 是远程设备的蓝牙地址。

**示例**

要连接 `<bt_address>` 为 `D4:8A:39:78:27:41` 的已配对远程设备，请运行以下命令：

```text theme={null}
connect D4:8A:39:78:27:41
```

**示例输出**

```text theme={null}
[bluetooth]# connect D4:8A:39:78:27:41
Attempting to connect to D4:8A:39:78:27:41
[CHG] Device D4:8A:39:78:27:41 Connected: yes
[NEW] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1
[NEW] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep2
[NEW] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep3
[NEW] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep4
[NEW] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep5
[NEW] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2
Connection successful
[NEW] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 [default]
[CHG] Device D4:8A:39:78:27:41 ServicesResolved: yes
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Repeat: off
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Shuffle: off
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Status: stopped
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Title: Not Provided
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 TrackNumber: 0x00000001 (1)
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 NumberOfTracks: 0x00000001 (1)
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Duration: 0x00000000 (0)
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Album:
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Artist:
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Genre:
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x00000000 (0)
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x00000000 (0)
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 Volume: 0x004d (77)
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 State: pending
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 State: active
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Status: playing
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x00000000 (0)
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 State: idle
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x00000000 (0)
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Status: stopped
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x00000000 (0)
[MyDeviceB]#
```

## 列出可用传输

要列出可用的传输，请在 `menu transport` 子菜单中运行以下命令：

```text theme={null}
list
```

**示例输出**

```text theme={null}
[MyDeviceB]# list
Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2
```

## 获取编解码器能力信息

要获取传输的编解码器能力信息，请在 `menu transport` 子菜单中运行以下命令：

```text theme={null}
show <transport>
```

**参数**

`<transport>` 是传输路径。

**示例**

要获取 `<transport>` 为 `/org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2` 的编解码器能力信息，请运行以下命令：

```text theme={null}
show /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2
```

**示例输出**

```text theme={null}
[MyDeviceB]# show /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2
Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2
   UUID: 0000110b-0000-1000-8000-00805f9b34fb
   Codec: 0x00 (0)
   Configuration: 0x21 (33)
   Configuration: 0x15 (21)
   Configuration: 0x02 (2)
   Configuration: 0x35 (53)
   Device: /org/bluez/hci0/dev_D4_8A_39_78_27_41
   State: active
   Volume: 0x007f (127)
```

## 设置绝对音量

<Note>
  请确保 DUT 和远程设备支持 `setabsvolume` 功能。
</Note>

要设置传输的绝对音量，请在 `menu transport` 子菜单中运行以下命令：

```text theme={null}
volume <transport> [value]
```

**参数**

* `<transport>` 是传输路径。

* `[value]` 是音量级别。

**示例**

要将 `<transport>` `/org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2` 的绝对音量设置为 `0`，请运行以下命令：

```text theme={null}
volume /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 0
```

**示例输出**

```text theme={null}
<me /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 0
Changing Volume succeeded
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 Volume: 0x0000 (0)
<me /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 100
Changing Volume succeeded
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 Volume: 0x0064 (100)
< /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 50
Changing Volume succeeded
```

## 播放音频文件

要播放音频文件，请在 `menu player` 子菜单中运行以下命令：

```text theme={null}
play [item]
```

**示例输出**

```text theme={null}
[MyDeviceB]# play
Attempting to play
Play successful
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 State: pending
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 State: active
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x000cc8b9 (837817)
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Status: playing
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x000cc932 (837938)
[MyDeviceB]#
```

## 暂停播放

要暂停播放，请在 `menu player` 子菜单中运行以下命令：

```text theme={null}
pause
```

**示例输出**

```text theme={null}
[MyDeviceB]# pause
Attempting to pause
Pause successful
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x000cc888 (837768)
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Status: paused
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x000cc888 (837768)
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 State: idle
[MyDeviceB]#
```

## 停止播放

要停止播放，请在 `menu player` 子菜单中运行以下命令：

```text theme={null}
stop
```

**示例输出**

```text theme={null}
[MyDeviceB]# stop
Attempting to stop
Stop successful
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x00000000 (0)
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Status: stopped
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x00000000 (0)
[CHG] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd2 State: idle
```

## 播放下一个音频文件

要播放下一个音频文件，请在 `menu player` 子菜单中运行以下命令：

```text theme={null}
next
```

**示例输出**

```text theme={null}
[MyDeviceB]# next
Attempting to jump to next
Next successful
```

## 播放上一个音频文件

要播放上一个音频文件，请在 `menu player` 子菜单中运行以下命令：

```text theme={null}
previous
```

**示例输出**

```text theme={null}
[MyDeviceB]# previous
Attempting to jump to previous
Previous successful
```

## 快进播放

要快进播放，请在 `menu player` 子菜单中运行以下命令：

```text theme={null}
fast-forward
```

**示例输出**

```text theme={null}
[MyDeviceB]# fast-forward
Fast forward playback
FastForward successful
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Status: forward-seek
[CHG] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 Position: 0x00000000 (0)
```

## 断开远程设备

要断开远程设备，请在 `bluetoothctl` 菜单中运行以下命令：

```text theme={null}
disconnect <bt_address>
```

**参数**

`<bt_address>` 是远程设备的蓝牙地址。

**示例**

要断开 `<bt_address>` 为 `D4:8A:39:78:27:41` 的已配对远程设备，请运行以下命令：

```text theme={null}
disconnect D4:8A:39:78:27:41
```

**示例输出**

```text theme={null}
[MyDeviceB]# disconnect D4:8A:39:78:27:41
Attempting to disconnect from D4:8A:39:78:27:41
[DEL] Player /org/bluez/hci0/dev_D4_8A_39_78_27_41/player0 [default]
[DEL] Transport /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1/fd1
[DEL] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep1
[DEL] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep2
[DEL] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep3
[DEL] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep4
[DEL] Endpoint /org/bluez/hci0/dev_D4_8A_39_78_27_41/sep5
[CHG] Device D4:8A:39:78:27:41 ServicesResolved: no
Successful disconnected
[CHG] Device D4:8A:39:78:27:41 Connected: no
```

## 其他播放器功能

`menu player` 子菜单还提供其他功能，使您可以：

* 随机播放曲目

* 快退音频文件

* 重复播放单个曲目、所有曲目或播放列表

* 打开或关闭均衡器

* 搜索曲目