蓝牙：Media Control Profile Shell
本文档介绍如何通过 shell 以客户端和服务器两种角色运行媒体控制功能。
媒体控制服务器由两部分组成：一是包含媒体处理逻辑的媒体播放器（mpl），二是作为播放器基于 GATT 的接口的媒体控制服务（mcs）。媒体控制客户端由一部分组成，即基于 GATT 的客户端（mcc）。
媒体控制服务器可以包含对象传输服务（ots），媒体控制客户端可以包含对象传输客户端（otc）。包含这些组件后，便可使用更丰富的功能。
媒体控制服务器和客户端都只实现通用媒体控制服务（Generic Media Control Service），不使用任何底层媒体控制服务。
请注意，在下面的示例中，许多情况下已删除调试输出，较长的输出也可能被缩短，以使示例更简短、清晰。
另请注意，本文档不会列出所有 shell 命令，只展示其中一些命令的示例。可以通过在 mcc shell 或 mpl shell 中输入 mcc 或 mpl 并按 TAB 键来查看命令集。每个命令的帮助文本可通过 mcc <command> help 或 mpl <command> help 查看。
概述
媒体播放器具有 名称 和 图标，便于用户识别播放器。
媒体播放器的内容按曲目和组进行组织。媒体播放器可以有多个组。一个组包含曲目和其他组。（在此实现中，一个组只包含曲目，不包含其他组。）曲目可以分为多个片段。
活动播放器会有 当前曲目。这是当前正在播放的曲目（如果播放器正在播放）。当前曲目具有 标题、时长 （以百分之一秒为单位）和 位置，即播放器在曲目中的当前位置。
此外还有 当前组 （当前曲目所属的组）、父组 （当前组的父组）和 下一曲目。
媒体播放器处于某种 状态，可以是播放中、暂停、跳转中或非活动。播放时，播放会以给定的 播放速度 进行，曲目按照 播放顺序 播放，该顺序是 支持的播放顺序 之一。曲目变化会作为 曲目已更改 特征的通知发出。跳转（快进或快退）时，曲目位置会根据 跳转速度 移动。
支持的操作码 通过写入 媒体控制点 来告知播放器支持哪些操作。此外还有一个 搜索控制点，可根据各种条件搜索组和曲目，结果在 搜索结果 中返回。
最后，内容控制 ID 用于将媒体播放器与音频流关联起来。
媒体控制客户端（MCP）
媒体控制客户端用于控制媒体控制服务器并从中获取信息。控制通过写入两个控制点之一或写入其他可写特征来完成。获取信息通过读取特征，或配置服务器发送通知来完成。
使用媒体控制客户端
使用前，必须通过 mcc init 命令初始化媒体控制客户端。
要与对端建立连接，必须使用 bt 命令：先执行 bt init，然后执行 bt advertise on （如果服务器正在广播，则执行 bt connect）。
当媒体控制客户端连接到媒体控制服务器后，客户端可以通过命令 mcc discover_mcs 发现服务器的通用媒体控制服务。该命令会存储服务的句柄，并且（可选，但默认启用）订阅所有通知。
发现后，媒体控制客户端可以读写特征，包括媒体控制点和搜索控制点。
用法示例
设置
uart:~$ bt init
Bluetooth initialized
uart:~$ mcc init
MCC init complete
uart:~$ bt advertise on
Advertising started
Connected: R:F6:58:DC:27:F3:57
连接后
服务发现（GMCS 及包含的 OTS）：
uart:~$ mcc discover_mcs
<dbg> bt_mcc.bt_mcc_discover_mcs: start discovery of MCS primary service
<dbg> bt_mcc.discover_primary_func: [ATTRIBUTE] handle 0x00ae
<dbg> bt_mcc.discover_primary_func: Primary discovery complete
<dbg> bt_mcc.discover_primary_func: UUID: 2800
<dbg> bt_mcc.discover_primary_func: UUID: 8fd7
<dbg> bt_mcc.discover_primary_func: Start discovery of MCS characteristics
<dbg> bt_mcc.discover_mcs_char_func: [ATTRIBUTE] handle 0x00b0
<dbg> bt_mcc.discover_mcs_char_func: Player name, UUID: 8fa0
<dbg> bt_mcc.discover_mcs_char_func: [ATTRIBUTE] handle 0x00b2
<dbg> bt_mcc.discover_mcs_char_func: Icon Object, UUID: 8fa1
<dbg> bt_mcc.discover_mcs_char_func: [ATTRIBUTE] handle 0x00b4
<dbg> bt_mcc.discover_mcs_char_func: Icon URI, UUID: 8fa2
<dbg> bt_mcc.discover_mcs_char_func: [ATTRIBUTE] handle 0x00b6
<dbg> bt_mcc.discover_mcs_char_func: Track Changed, UUID: 8fa3
<dbg> bt_mcc.discover_mcs_char_func: Subscribing - handle: 0x00b6
[...]
<dbg> bt_mcc.discover_mcs_char_func: [ATTRIBUTE] handle 0x00ea
<dbg> bt_mcc.discover_mcs_char_func: Content Control ID, UUID: 8fb5
<dbg> bt_mcc.discover_mcs_char_func: Setup complete for MCS
<dbg> bt_mcc.discover_mcs_char_func: Start discovery of included services
<dbg> bt_mcc.discover_include_func: [ATTRIBUTE] handle 0x00af
<dbg> bt_mcc.discover_include_func: Include UUID 1825
<dbg> bt_mcc.discover_include_func: Discover include complete for MCS: OTS
<dbg> bt_mcc.discover_include_func: Start discovery of OTS characteristics
<dbg> bt_mcc.discover_otc_char_func: [ATTRIBUTE] handle 0x009c
<dbg> bt_mcc.discover_otc_char_func: OTS Features
[...]
<dbg> bt_mcc.discover_otc_char_func: [ATTRIBUTE] handle 0x00ac
<dbg> bt_mcc.discover_otc_char_func: Object Size
Discovery complete
<dbg> bt_otc.bt_otc_register: 0
<dbg> bt_otc.bt_otc_register: L2CAP psm 0x 25 sec_level 1 registered
<dbg> bt_mcc.discover_otc_char_func: Setup complete for OTS 1 / 1
uart:~$
读取特征——以播放器名称和曲目时长为例：
uart:~$ mcc read_player_name
Player name: My media player
4d 79 20 6d 65 64 69 61 20 70 6c 61 79 65 72 |My media player
uart:~$ mcc read_track_duration
Track duration: 6300
请注意，某些特征的值可能因过长而无法放入 ATT 数据包，从而被截断。增大 ATT MTU 可能会有所帮助：
uart:~$ mcc read_track_title
Track title: Interlude #1 (Song for
uart:~$ gatt exchange-mtu
Exchange pending
Exchange successful
uart:~$ mcc read_track_title
Track title: Interlude #1 (Song for Alison)
写入特征——以曲目位置为例：
曲目位置是播放器在当前曲目中的“位置”。读取曲目位置，通过写入更改它，然后再次读取以确认。
uart:~$ mcc read_track_position
Track Position: 0
uart:~$ mcc set_track_position 500
Track Position: 500
uart:~$ mcc read_track_position
Track Position: 500
通过控制点控制播放器：
写入控制点可以让客户端请求服务器执行播放、暂停、快进、切换曲目、切换组等操作。某些操作（例如转到曲目）需要参数。目前，控制点 shell 命令使用原始操作码值作为输入。这些操作码值可在 mpl.h 头文件中找到。
发送播放命令（操作码“1”）、转到第三首曲目的命令（操作码“52”）以及暂停命令（操作码“2”）：
uart:~$ mcc set_cp 1
Media State: 1
Operation: 1, result: 1
Operation: 1, param: 0
uart:~$ mcc set_cp 52 3
Track changed
Track title: Interlude #3 (Levanto Seventy)
Track duration: 7800
Track Position: 0
Current Track Object ID: 0x000000000104
Next Track Object ID: 0x000000000105
Operation: 52, result: 1
Operation: 52, param: 3
uart:~$ mcc set_cp 2
Media State: 2
Operation: 2, result: 1
Operation: 2, param: 0
使用包含的对象传输客户端
当客户端和服务器都支持对象传输时，可以使用更多特征。这些特征包括各种曲目和组对象的对象 ID。可以使用这些 ID 从服务器的对象传输服务中选择并下载相应对象。
读取当前组对象的对象 ID：
uart:~$ mcc read_current_group_obj_id
Current Group Object ID: 0x000000000107
选择具有该 ID 的对象：
uart:~$ mcc ots_select 0x107
Selecting object succeeded
读取对象的元数据：
uart:~$ mcc ots_read_metadata
Reading object metadata succeeded
<inf> bt_mcc: Object's meta data:
<inf> bt_mcc: Current size :35
<inf> bt_otc: --- Displaying 1 metadata records ---
<inf> bt_otc: Object ID: 0x000000000107
<inf> bt_otc: Object name: Joe Pass - Guitar Inte
<inf> bt_otc: Object Current Size: 35
<inf> bt_otc: Object Allocate Size: 35
<inf> bt_otc: Type: Group Obj Type
<inf> bt_otc: Properties:0x4
<inf> bt_otc: - read permitted
读取对象本身：
收到的对象是组对象。它由一系列记录组成，每条记录包含类型（曲目或组）和对象 ID。
uart:~$ mcc ots_read_current_group_object
<dbg> bt_mcc.on_group_content: Object type: 0, object ID: 0x000000000102
<dbg> bt_mcc.on_group_content: Object type: 0, object ID: 0x000000000103
<dbg> bt_mcc.on_group_content: Object type: 0, object ID: 0x000000000104
<dbg> bt_mcc.on_group_content: Object type: 0, object ID: 0x000000000105
<dbg> bt_mcc.on_group_content: Object type: 0, object ID: 0x000000000106
搜索
搜索控制点以一系列搜索控制项作为输入，每个搜索控制项由长度、类型（例如曲目名称或艺术家名称）和参数（要搜索的曲目名称或艺术家名称）组成。如果搜索成功，搜索结果会存储在对象传输服务的一个对象中。搜索结果 ID 对象的 ID 可以从搜索结果对象 ID 特征中读取。然后可以像上面的当前组对象一样下载搜索结果对象。（请注意，在执行搜索之前，搜索结果对象 ID 为空。）
此实现包含可用的搜索功能接口实现以及服务器端搜索控制点参数解析。但 实际搜索是模拟的，无论搜索什么，都会返回相同的结果。
搜索有两个命令：一个（mcc set_scp_raw）允许以字符串形式输入搜索控制点参数（一系列搜索控制项）。另一个（mcc set_scp_ioptest）执行预设的 IOP 测试搜索，并以 IOP 搜索控制点测试的轮次编号作为参数。
搜索之前，搜索结果对象 ID 为空
uart:~$ mcc read_search_results_obj_id
Search Results Object ID: 0x000000000000
<dbg> bt_mcc.mcc_read_search_results_obj_id_cb: Zero-length Search Results Object ID
运行 IOP 测试第四轮对应的搜索：
此命令和参数生成的搜索控制点参数包含一个搜索控制项。长度字段（第一个八位字节）为 16（0x10）。（长度字段本身的长度不计入。）类型字段（第二个八位字节）为 0x04（搜索组名称）。参数（要搜索的组名称）为“TSPX_Group_Name”。
uart:~$ mcc set_scp_ioptest 4
Search string:
00000000: 10 04 54 53 50 58 5f 47 72 6f 75 70 5f 4e 61 6d |..TSPX_G roup_Nam|
00000010: 65 |e |
Search control point notification result code: 1
Search Results Object ID: 0x000000000107
Search Control Point set
搜索成功后，搜索结果对象 ID 会有一个值：
uart:~$ mcc read_search_results_obj_id
Search Results Object ID: 0x000000000107
媒体控制服务（MCS）
媒体控制服务（mcs）及关联的媒体播放器（mpl）通常位于能够提供和供应媒体内容的设备上，例如 PC 和智能手机。
如上所述，媒体播放器（mpl）具有播放器逻辑，而媒体控制服务（mcs）具有基于 GATT 的接口。之所以这样分离，是为了让媒体播放器也可以在没有基于 GATT 的接口的情况下使用。
使用媒体控制服务和媒体播放器
媒体控制服务和媒体播放器通常由媒体控制客户端远程控制。
使用前，必须通过 mpl init 命令初始化媒体控制客户端。
与客户端一样，连接时使用 bt 命令：先执行 bt init，然后执行 bt connect <address> <address type> （如果服务器正在广播，则执行 bt advertise on）。
用法示例
Setup
uart:~$ bt init
Bluetooth initialized
uart:~$ mpl init
[Large amounts of debug output]
uart:~$ bt connect R:F9:33:3B:67:D2:A7
Connection pending
Connected: R:F9:33:3B:67:D2:A7
When connected
控制从客户端执行。
服务器会输出与客户端执行的各种操作相关的调试信息。
示例：客户端发出“下一曲目”命令时服务器输出的调试信息：
[00:13:29.932,373] <dbg> bt_mcs.control_point_write: Opcode: 49
[00:13:29.932,403] <dbg> bt_mpl.mpl_operation_set: opcode: 49, param: 536880068
[00:13:29.932,403] <dbg> bt_mpl.paused_state_operation_handler: Operation opcode: 49
[00:13:29.932,495] <dbg> bt_mpl.do_next_track: Track ID before: 0x000000000104
[00:13:29.932,586] <dbg> bt_mpl.do_next_track: Track ID after: 0x000000000105
[00:13:29.932,617] <dbg> bt_mcs.mpl_track_changed_cb: Notifying track change
[00:13:29.932,708] <dbg> bt_mcs.mpl_track_title_cb: Notifying track title: Interlude #4 (Vesper Dreams)
[00:13:29.932,800] <dbg> bt_mcs.mpl_track_duration_cb: Notifying track duration: 13500
[00:13:29.932,861] <dbg> bt_mcs.mpl_track_position_cb: Notifying track position: 0
[00:13:29.933,044] <dbg> bt_mcs.mpl_current_track_id_cb: Notifying current track ID: 0x000000000105
[00:13:29.933,258] <dbg> bt_mcs.mpl_next_track_id_cb: Notifying next track ID: 0x000000000106
[00:13:29.933,380] <dbg> bt_mcs.mpl_operation_cb: Notifying control point - opcode: 49, result: 1
服务器提供了一些命令。这些命令会强制发送各种特征的通知，以测试客户端能否收到通知。这些测试命令所发送通知中的值与媒体播放器无关，因此它们既不对应特征的实际值，也不对应媒体播放器的实际状态。
示例：强制发送曲目时长的（模拟值）通知：
uart:~$ mpl duration_changed_cb
[00:15:17.491,058] <dbg> bt_mcs.mpl_track_duration_cb: Notifying track duration: 12000