【AVRCP】Notification PDUs 深入解析与应用

AVRCP（音频/视频远程控制协议）中的 Notification PDUs(通知 PDU) 是实现设备间状态同步的核心机制，允许控制器（Controller, CT）主动获取或订阅目标设备（Target, TG）的实时状态变化，无论是同步还是异步更新。本文将深入解析其工作原理、关键命令及实际应用场景。

一、Notification PDUs 概述

作用：通知 PDU（Protocol Data Unit）用于在目标设备（TG）状态改变时，为控制设备（CT）提供同步和异步更新。
应用场景：当控制终端（CT，Control Terminal）想知道媒体轨道的当前状态或其变化情况，以便在控制器显示屏上显示新的媒体信息。CT 可以选择查询播放状态，或者向 TG 注册以接收播放状态通知。当 CT 注册了特定状态变化的通知后，TG 在状态改变时会发送通知 PDU。
实现方式：通知 PDU 分为两种类型：
- 同步查询：CT 主动向 TG 请求当前状态。
- 异步订阅：CT 注册特定事件，TG 在状态变化时自动推送通知。

这种机制适用于媒体播放状态更新（如播放/暂停）、电池状态变化等场景，确保 CT 界面信息与 TG 实际状态一致。

二、GetPlayStatus：同步查询播放状态

2.1 命令功能与应用场景

作用：CT 通过此命令实时获取 TG 的播放状态、曲目时长和播放进度。 典型场景：

用户手动点击播放器界面的“刷新”按钮
界面初始化时加载当前播放信息
处理用户操作（如暂停/播放）后验证状态

2.2 请求格式（CT → TG）

无参数：命令本身不携带任何附加数据
传输效率：命令包仅需 3 字节（包括 AVRCP 头部）

HCI LOG：

2.3 响应格式（TG → CT）

响应参数详解：

①曲目时长（SongLength）

字段	值范围	特殊值	处理逻辑
SongLength	0x00000000 ~ 0xFFFFFFFF	0xFFFFFFFF	显示"未知时长"，禁用进度条拖拽功能

示例：

0x000EA600 → 转换为十进制 60,000 毫秒（1分钟）
0xFFFFFFFF → TG 不支持时长反馈

②播放位置（SongPosition）

字段	值范围	特殊值	处理逻辑
SongPosition	0x00000000 ~ 0xFFFFFFFF	0xFFFFFFFF	显示"未知位置"，停止进度条自动更新

动态行为：

播放时每秒变化约 1000 次（1秒=1000ms）
快进/快退时数值跳跃变化（需结合 PlayStatus 状态处理）

③播放状态（PlayStatus）

状态码	含义	典型触发场景	界面表现建议
0x00	STOPPED	用户点击停止/播放完成	显示停止图标，进度条归零
0x01	PLAYING	用户点击播放/恢复播放	显示播放图标，进度条持续更新
0x02	PAUSED	用户主动暂停	显示暂停图标，进度条静止
0x03	FWD_SEEK	用户长按快进键	显示快进图标，进度条快速前进
0x04	REV_SEEK	用户长按后退键	显示后退图标，进度条快速回退
0xFF	ERROR	设备异常/媒体加载失败	显示错误提示，重置播放控件

HCI LOG:

2.4 注意事项

①字节序处理：所有 4 字节参数需按 大端序（Big-Endian） 解析：

song_length = int.from_bytes(data[0:4], byteorder='big')

②特殊值 0xFFFFFFFF

if (song_length == 0xFFFFFFFF) {
    show_label("时长未知");
    disable_seekbar();
}

③状态同步策略

高频查询限制：建议最小间隔 ≥500ms，避免频繁请求导致设备过载
结合异步通知：与 RegisterNotification(EVENT_PLAYBACK_POS_CHANGED) 配合使用

④错误恢复机制

function handlePlayStatus(response) {
    if (response.playStatus === 0xFF) {
        retryCount++;
        if (retryCount < 3) {
            setTimeout(fetchPlayStatus, 1000);
        } else {
            showErrorMessage("设备连接异常");
        }
    }
}

2.5 协议实现示例（伪代码）

#include <stdio.h>
#include <stdint.h>

// 定义 GetPlayStatus 命令结构体
typedef struct {
    // 该命令无参数
} GetPlayStatusCommand;

// 定义 GetPlayStatus 响应结构体
typedef struct {
    uint32_t songLength;
    uint32_t songPosition;
    uint8_t playStatus;
} GetPlayStatusResponse;

// 模拟 CT 发送 GetPlayStatus 命令
void sendGetPlayStatusCommand() {
    GetPlayStatusCommand command;
    // 这里模拟发送命令到 TG，实际应用中可能通过蓝牙协议栈发送
    printf("CT 发送 GetPlayStatus 命令\n");
    // 假设这里将命令发送到某个函数进行处理
    // send_command_to_tg(&command);
}

// 模拟 TG 接收 GetPlayStatus 命令并返回响应
GetPlayStatusResponse receiveGetPlayStatusCommand() {
    GetPlayStatusResponse response;
    // 模拟获取播放状态信息
    // 假设 TG 支持获取 SongLength 和 SongPosition
    response.songLength = 300000; // 假设歌曲时长为 300000 毫秒
    response.songPosition = 150000; // 假设当前播放位置为 150000 毫秒
    response.playStatus = 0x01; // 假设当前播放状态为 PLAYING

    // 如果 TG 不支持 SongLength 和 SongPosition
    // response.songLength = 0xFFFFFFFF;
    // response.songPosition = 0xFFFFFFFF;

    printf("TG 接收 GetPlayStatus 命令并返回响应\n");
    return response;
}

// 模拟 CT 接收 GetPlayStatus 响应
void receiveGetPlayStatusResponse(GetPlayStatusResponse response) {
    printf("CT 接收 GetPlayStatus 响应\n");
    printf("歌曲总时长: %u 毫秒\n", response.songLength);
    printf("当前播放位置: %u 毫秒\n", response.songPosition);
    switch (response.playStatus) {
        case 0x00:
            printf("播放状态: STOPPED\n");
            break;
        case 0x01:
            printf("播放状态: PLAYING\n");
            break;
        case 0x02:
            printf("播放状态: PAUSED\n");
            break;
        case 0x03:
            printf("播放状态: FWD_SEEK\n");
            break;
        case 0x04:
            printf("播放状态: REV_SEEK\n");
            break;
        case 0xFF:
            printf("播放状态: ERROR\n");
            break;
        default:
            printf("未知播放状态\n");
    }
}

int main() {
    // CT 发送 GetPlayStatus 命令
    sendGetPlayStatusCommand();

    // TG 接收命令并返回响应
    GetPlayStatusResponse response = receiveGetPlayStatusCommand();

    // CT 接收响应
    receiveGetPlayStatusResponse(response);

    return 0;
}

三、RegisterNotification：异步事件订阅

3.1 命令概述

目的：用于在目标设备（TG）上注册，以便基于特定事件异步接收通知。

双重响应机制:

INTERIM 响应(初始响应)：接收到命令后，应在TMTP(200ms)时间内返回INTERIM响应（当前状态）。
CHANGED 响应(后续响应)：异步推送状态变化
错误处理：可能返回 REJECTED（0x0A）/NOT_IMPLEMENTED（0x08）

核心机制图解：

协议关键特性对照表

特性	详细说明	开发者必须注意
单事件注册	每个命令仅支持1个EventID	监听多事件需多次发送命令
双重响应机制	INTERIM(即时状态) + CHANGED(变更推送)	需分别实现两种响应处理逻辑
播放间隔限制	仅对EVENT_PLAYBACK_POS_CHANGED有效	其他事件设置间隔参数无效但不会报错
重注册要求	TRACK_REACHED_END/START触发后需重新注册	未重新注册会导致后续事件丢失
超时机制	INTERIM响应需在TMTP时间内返回(通常≤200ms)	超时未响应应触发重发机制

3.2 命令格式

EventID（1字节）：需要通知的事件。参考下表。

Playback interval（4字节）：播放位置变化通知的时间间隔（秒）。仅适用于EVENT_PLAYBACK_POS_CHANGED事件。
关键限制:
- 单事件注册：每个命令仅支持一个 EventID
- 播放间隔策略：仅对 EVENT_PLAYBACK_POS_CHANGED 有效
- 重注册要求：TRACK_REACHED_END/START 事件触发后需重新注册

HCI LOG:

3.3 响应格式

根据不同的事件，响应格式有所不同。以下是主要事件的响应格式：

①EVENT_PLAYBACK_STATUS_CHANGED（通知播放状态的改变）

用途：通知注册客户端播放状态的实时变化（如播放、暂停、快进等）。
触发条件：当播放器状态发生改变时自动推送。

实现要点

固定长度：总数据包长度为 2字节，无需处理动态长度。
字节序：单字节字段不涉及字节序问题，直接按顺序解析。
错误处理：收到 0xFF 时，客户端应触发错误处理机制（如日志记录、用户提示）。

应用场景

媒体控制器：根据状态更新UI（如切换播放/暂停图标）。
自动化系统：状态变更时触发后续操作（如播放结束后自动关闭设备）。
调试工具：监控状态流，诊断播放异常问题。

HCI LOG：

伪代码示例（C语言）

typedef enum {
    PLAYBACK_STOPPED  = 0x00,
    PLAYBACK_PLAYING  = 0x01,
    PLAYBACK_PAUSED   = 0x02,
    PLAYBACK_FWD_SEEK = 0x03,
    PLAYBACK_REV_SEEK = 0x04,
    PLAYBACK_ERROR    = 0xFF
} PlaybackStatus;

typedef struct {
    uint8_t eventID;      // 应恒为0x01
    PlaybackStatus status;
} PlaybackStatusEvent;

void handleEvent(const uint8_t* data) {
    PlaybackStatusEvent event;
    memcpy(&event, data, sizeof(event));
    if (event.eventID != 0x01) return;  // 验证事件ID

    switch (event.status) {
        case PLAYBACK_PLAYING:
            // 更新为播放状态
            break;
        case PLAYBACK_ERROR:
            // 处理错误逻辑
            break;
        // 其他状态处理...
    }
}

测试建议：

覆盖所有状态：模拟发送各编码值，验证客户端响应是否符合预期。
异常数据测试：发送非法值（如0x05）检验容错机制。
并发测试：高频状态切换时确保系统稳定性。

②EVENT_TRACK_CHANGED（通知媒体轨道的改变）

用途：通知客户端当前播放曲目发生变更（如切歌、播放新文件）。
触发条件：播放器切换媒体元素时自动推送。
核心参数：通过唯一标识符（Identifier）定位具体媒体资源。
Identifier 规则：

场景	标识符值（HEX）	说明
曲目被选中，且不支持浏览	0x0000000000000000	强制返回零值
无选中曲目（INTERIM响应）	0xFFFFFFFFFFFFFFFF	表示空状态
支持浏览且曲目被选中	有效媒体元素标识符	必须对应NowPlaying文件夹中的条目
错误/非法操作	非上述值的其他无效标识符	需触发错误处理

数据包示例：

常规播放（支持浏览） 0x02 0xA1B2C3D4E5F60708 （EventID=0x02，Identifier=有效媒体元素ID）
无曲目状态（INTERIM响应） 0x02 0xFFFFFFFFFFFFFFFF （EventID=0x02，Identifier=空状态）
不支持浏览的播放器 0x02 0x0000000000000000 （EventID=0x02，Identifier=强制零值）

关键实现逻辑

浏览支持性检测
- 需在初始化阶段通过协议协商确定是否支持浏览功能
- 影响Identifier的生成规则（是否允许0x0）
标识符映射
- 支持浏览时，Identifier必须与NowPlaying列表中的元素严格一致
- 可通过GetItemAttributes命令获取详细信息
临时状态处理
- 当播放队列为空或未选择曲目时，主动发送0xFFFFFFFFFFFFFFFF

HCI lOG:

应用场景

智能音箱：切换歌曲时同步更新显示曲目元数据
车载系统：根据Identifier快速加载预存的专辑封面
多房间音频：跨设备同步当前播放标识符以实现队列同步

伪代码示例（C语言）

typedef struct {
    uint8_t eventID;        // 固定为0x02
    uint64_t identifier;    // 大端或小端需根据协议定义
} TrackChangedEvent;

void handleTrackChanged(const uint8_t* data) {
    TrackChangedEvent event;
    memcpy(&event, data, sizeof(event));
    
    if (event.eventID != 0x02) return;

    const bool browsingSupported = checkBrowsingSupport(); // 预存的浏览能力标志
    
    if (browsingSupported) {
        if (event.identifier == 0x0) {
            logError("Illegal 0x0 identifier with browsing enabled");
        } else {
            updateNowPlayingItem(event.identifier); // 从NowPlaying加载详细信息
        }
    } else {
        if (event.identifier != 0x0) {
            requestFullMetadata(); // 回退到完整元数据请求
        }
    }
}

测试用例设计

测试场景	预期结果	验证点
支持浏览的正常切歌	收到有效非零标识符	标识符是否匹配NowPlaying列表
不支持浏览时播放	标识符恒为0x0	是否拒绝非零值
清空播放队列	收到0xFFFFFFFFFFFFFFFF	UI是否显示"无曲目"状态
发送非法8字节标识符（如全0xFF）	触发错误处理流程	是否记录错误且不崩溃

③EVENT_TRACK_REACHED_END / START

用途：
- EVENT_TRACK_REACHED_END (0x03)：通知客户端当前曲目播放至末尾（如自然结束、手动跳转至结尾）。
- EVENT_TRACK_REACHED_START (0x04)：通知客户端当前曲目回放至起始点（如倒带至开头）。
触发条件：播放进度达到曲目边界时自动触发。
核心特性：无附加参数，仅通过事件ID标识状态变化。

关键实现逻辑

事件注册机制：客户端响应事件后若需执行操作（如获取元数据），必须重新注册事件以确保后续状态变更能被捕获。
- 原因：避免因操作延迟导致中间状态丢失（例如：播放器在获取元数据时用户已切换曲目）。
无附加参数处理：
- 数据包长度固定为1字节，多余字节应视为协议错误。
- 接收后仅需校验EventID有效性，无需解析额外字段。

应用场景

事件类型	典型场景
REACHED_END	- 自动播放下一曲目 - 更新播放队列 - 记录播放历史
REACHED_START	- 单曲循环模式重置进度 - 显示"曲目起点"提示 - 启用反向播放功能

错误处理策略

错误类型	处理方案
非法EventID	丢弃数据包，记录错误日志（如收到0x05）
数据包长度异常	校验长度是否为1字节，否则触发协议解析错误
未注册事件	忽略或发送警告通知（根据协议严格性决定）

伪代码示例（C语言）

typedef enum {
    EVENT_PLAYBACK_STATUS_CHANGED = 0x01,
    EVENT_TRACK_CHANGED           = 0x02,
    EVENT_TRACK_REACHED_END       = 0x03,  // 新增事件类型
    EVENT_TRACK_REACHED_START     = 0x04   // 新增事件类型
} EventID;

void handleEvent(const uint8_t* data, size_t len) {
    if (len != 1) {
        logError("Invalid event packet length");
        return;
    }

    switch (data[0]) {
        case EVENT_TRACK_REACHED_END:
            onTrackEnd();
            reRegisterEvent(EVENT_TRACK_REACHED_END);  // 关键：重新注册
            break;
        case EVENT_TRACK_REACHED_START:
            onTrackStart();
            reRegisterEvent(EVENT_TRACK_REACHED_START); // 关键：重新注册
            break;
        default:
            logError("Unknown EventID: 0x%02X", data[0]);
    }
}

// 示例：响应曲目结束事件
void onTrackEnd() {
    printf("Track reached end, preparing next...\n");
    fetchNextTrack(); // 例如调用GetElementAttributes
}

测试用例设计

测试场景	预期结果	验证点
正常接收END事件（0x03）	触发onTrackEnd逻辑并重新注册事件	事件处理函数是否执行且重新注册
发送非法EventID（如0x05）	记录错误日志且不崩溃	错误处理健壮性
数据包长度超1字节（如0x03 00）	触发协议错误	长度校验是否严格
连续发送多个END事件	每次均正确处理并重新注册	事件队列管理能力

协议注意事项

重入问题：避免在事件处理函数中再次触发相同事件导致递归调用（如：在onTrackEnd中立即切歌可能再次触发END事件）。
时序控制：重新注册事件应作为原子操作，确保在后续操作前完成注册。
跨平台兼容性：单字节传输无字节序问题，但需确认协议是否隐含大端/小端约定。

④EVENT_PLAYBACK_POS_CHANGED（通知播放位置的改变）

用途：实时反馈播放进度变化，支持精确到毫秒的进度同步。
触发条件：
- 达到预设的位置上报间隔（如每隔1秒自动上报）
- 播放状态变更（如PLAYING→PAUSED）
- 曲目切换（新曲目开始播放）
- 到达曲目边界（0ms或曲目总时长）
核心参数：含4字节进度值，支持特殊状态标记。

数据包示例

正常播放：0x05 0x00 0x00 0x03 0xE8 （EventID=0x05，Position=1000ms，小端表示）
无曲目状态：0x05 0xFF 0xFF 0xFF 0xFF （EventID=0x05，Position=0xFFFFFFFF）
曲目结尾：0x05 0x00 0x1E 0x84 0x80 （EventID=0x05，Position=2,000,000ms ≈33分钟）

关键实现逻辑

字节序处理：

uint32_t position = (data[1] << 24) | (data[2] << 16) | (data[3] << 8) | data[4]; // 大端解析

或使用网络字节序转换函数：

uint32_t position = ntohl(*(uint32_t*)(data+1)); // 兼容不同平台

特殊值处理：

if (position == 0xFFFFFFFF) {
    showNoTrackWarning();
    return; // 不更新进度显示
}

事件重入控制：

void onPositionChanged(uint32_t pos) {
    if (lastPos == pos) return; // 过滤重复事件
    updateProgressBar(pos);
    lastPos = pos;
}

应用场景

场景	实现方案
实时进度条	将毫秒值转换为mm:ss格式显示
智能歌词滚动	根据位置匹配歌词时间戳
播放速度同步	对比连续事件的时间差计算实际播放速率
断点续播	存储最后有效位置，下次启动时自动跳转

错误处理策略

错误类型	处理方案
位置值越界	对比曲目总时长，过滤异常值并记录日志
非法字节序	使用校验位或协议版本协商确定字节序规则
高频事件阻塞	增加事件队列缓冲，异步处理防止UI卡死

伪代码示例（C语言）

#include <stdint.h>
#include <stdio.h>
#include <arpa/inet.h>  // 用于字节序转换（Linux环境）

// ----------------------------
// 1. 数据结构定义
// ----------------------------
#pragma pack(push, 1)  // 确保1字节对齐
typedef struct {
    uint8_t  event_id;      // 事件ID (固定0x05)
    uint32_t position_ms;   // 播放位置（单位：毫秒，网络字节序）
} PlaybackPosEvent;
#pragma pack(pop)

// ----------------------------
// 2. 全局状态变量（示例）
// ----------------------------
static uint32_t g_current_position = 0;
static uint32_t g_track_duration   = 0;  // 当前曲目总时长（单位：毫秒）

// ----------------------------
// 3. 事件处理函数
// ----------------------------
/**
 * @brief 处理播放位置变更事件
 * @param data 原始数据指针
 * @param len  数据长度
 */
void handle_playback_pos_changed(const uint8_t* data, size_t len) {
    // 校验数据长度
    if (len != sizeof(PlaybackPosEvent)) {
        fprintf(stderr, "[ERROR] Invalid packet length: %zu (expected %zu)\n",
                len, sizeof(PlaybackPosEvent));
        return;
    }

    // 解析数据包
    PlaybackPosEvent event;
    memcpy(&event, data, sizeof(event));

    // 校验事件ID合法性
    if (event.event_id != 0x05) {
        fprintf(stderr, "[ERROR] Invalid EventID: 0x%02X\n", event.event_id);
        return;
    }

    // 转换字节序（网络字节序 → 主机字节序）
    uint32_t position = ntohl(event.position_ms);

    // 处理特殊值：无曲目状态
    if (position == 0xFFFFFFFF) {
        printf("[INFO] No track selected.\n");
        g_current_position = 0;
        return;
    }

    // 校验位置合理性（可选）
    if (g_track_duration > 0 && position > g_track_duration) {
        fprintf(stderr, "[WARN] Position %u exceeds track duration %u\n",
                position, g_track_duration);
        position = g_track_duration;  // 强制修正为最大值
    }

    // 更新全局状态
    g_current_position = position;

    // 示例：打印进度信息
    uint32_t seconds = position / 1000;
    printf("[DEBUG] Position: %02u:%02u.%03u\n", 
           seconds / 60, seconds % 60, position % 1000);
}

// ----------------------------
// 4. 事件注册与重注册逻辑（示例）
// ----------------------------
/**
 * @brief 向设备注册位置变更事件通知
 * @param interval_ms 上报间隔（毫秒）
 */
void register_playback_pos_event(uint32_t interval_ms) {
    // 模拟向设备发送注册命令（协议格式需自定义）
    send_command_to_device(0x05, interval_ms);
    printf("[INFO] Registered playback position event (interval=%ums)\n", interval_ms);
}

/**
 * @brief 在响应事件后重新注册以确保后续通知
 */
void re_register_event_after_handling() {
    // 实际场景可能需要根据设备要求设置间隔
    register_playback_pos_event(1000);  // 重新注册1秒间隔
}

// ----------------------------
// 5. 辅助函数（模拟实现）
// ----------------------------
// 模拟向设备发送命令（具体实现依赖硬件协议栈）
void send_command_to_device(uint8_t event_id, uint32_t interval_ms) {
    // 实现细节省略（如构造二进制命令并发送）
}

// ----------------------------
// 6. 测试用例示例
// ----------------------------
int main() {
    // 模拟接收数据包（大端字节序）
    uint8_t sample_data[] = {0x05, 0x00, 0x00, 0x03, 0xE8};  // 0x000003E8 = 1000ms
    handle_playback_pos_changed(sample_data, sizeof(sample_data));

    // 模拟无曲目状态
    uint8_t empty_track_data[] = {0x05, 0xFF, 0xFF, 0xFF, 0xFF};
    handle_playback_pos_changed(empty_track_data, sizeof(empty_track_data));

    return 0;
}

测试用例设计

测试场景	预期结果	验证点
正常位置递增（0→1000→2000ms）	进度条平滑更新，时间显示正确	数据解析准确性
收到0xFFFFFFFF	显示"无曲目"提示，进度条隐藏	特殊值处理逻辑
发送超过曲目时长的位置值	自动修正为最大值或触发错误	数据校验机制
密集事件（每秒100次）	UI无卡顿，事件队列不溢出	系统资源管理能力

跨协议关联

关联事件	协同逻辑
EVENT_TRACK_CHANGED	曲目切换时重置进度为0并触发位置事件
EVENT_PLAY_STATUS	暂停/播放时暂停/恢复进度计时器
EVENT_TRACK_END	到达结尾时位置值应等于曲目总时长

HCI LOG:

⑤EVENT_BATT_STATUS_CHANGED

用途：通知客户端设备电源状态变化（如电量不足、充电状态切换）。
触发条件：电池状态发生变更时自动触发（如电量下降至阈值、插入外部电源）。
弃用说明：该事件未来将被属性配置文件（Attribute Profile）替代，建议新开发兼容双方案。

电池状态值详解：

运行状态（0x0 - NORMAL）
- 场景：设备电池电量充足（通常≥20%），正常运行。
- CT 处理：无需特殊提示，可在界面显示电池百分比（若支持）。
低电量警告（0x1 - WARNING）
- 场景：电池电量下降至临界值（如 5%-20%），设备即将无法工作。
- CT 处理：显示黄色警告图标，提示用户准备充电（如蓝牙耳机提示 “电量低”）。
电量临界（0x2 - CRITICAL）
- 场景：电池电量极低（如 < 5%），设备即将关机。
- CT 处理：显示红色警告，强制提示充电（如自动降低亮度、断开非必要连接）。
外部供电（0x3 - EXTERNAL）
- 场景：设备通过充电器 / USB 连接供电。
- CT 处理：显示充电图标，可能隐藏电池百分比（如音箱连接电源时）。
充满电（0x4 - FULL_CHARGE）
- 场景：外部供电且电池已充满。
- CT 处理：显示 “已充满” 状态，可提示用户移除充电器（如智能耳机盒）。

应用场景

场景	实现方案
UI电量图标	根据状态切换图标（电池/充电/警告）
低电量弹窗	检测到WARNING/CRITICAL时弹出提示
充电状态监控	在EXTERNAL状态下显示充电动画
数据自动保存	CRITICAL状态触发紧急保存并关机

注意事项

协议过渡：未来弃用后需迁移至属性配置文件，建议抽象状态处理层。
保留值处理：收到0x05~0xFF时标记为"UNKNOWN"，避免逻辑中断。
状态冲突：外部电源插入时，若同时电量低，优先上报EXTERNAL状态。

伪代码示例（C语言）

#include <stdint.h>

// ----------------------------
// 1. 状态枚举定义
// ----------------------------
typedef enum {
    BATT_NORMAL      = 0x00,
    BATT_WARNING     = 0x01,
    BATT_CRITICAL    = 0x02,
    BATT_EXTERNAL    = 0x03,
    BATT_FULL_CHARGE = 0x04
} BatteryStatus;

// ----------------------------
// 2. 事件数据结构
// ----------------------------
#pragma pack(push, 1)
typedef struct {
    uint8_t event_id;
    BatteryStatus status;
} BattStatusEvent;
#pragma pack(pop)

// ----------------------------
// 3. 事件处理函数
// ----------------------------
void handle_batt_status(const uint8_t* data, size_t len) {
    // 校验数据长度
    if (len != sizeof(BattStatusEvent)) {
        fprintf(stderr, "Invalid battery event length: %zu\n", len);
        return;
    }

    // 解析数据
    BattStatusEvent event;
    memcpy(&event, data, sizeof(event));

    // 校验EventID
    if (event.event_id != 0x06) {
        fprintf(stderr, "Invalid EventID: 0x%02X\n", event.event_id);
        return;
    }

    // 校验状态合法性
    if (event.status > BATT_FULL_CHARGE) {
        fprintf(stderr, "Invalid battery status: 0x%02X\n", event.status);
        return;
    }

    // 更新系统电源状态
    update_power_status(event.status);
}

// ----------------------------
// 4. 状态处理示例
// ----------------------------
void update_power_status(BatteryStatus status) {
    switch (status) {
        case BATT_WARNING:
            show_low_battery_warning(20);  // 示例：显示20%电量提示
            break;
        case BATT_CRITICAL:
            save_unsaved_data();
            initiate_graceful_shutdown();
            break;
        case BATT_EXTERNAL:
            set_charging_led(true);
            break;
        case BATT_FULL_CHARGE:
            set_charging_led(false);
            show_full_charge_notification();
            break;
    }
}

测试用例设计：

测试场景	输入数据	预期行为
正常电量状态	0x06 0x00	UI显示满电量图标
临界电量事件	0x06 0x02	触发数据保存并准备关机
插入充电器	0x06 0x03	充电指示灯亮起
无效状态值（0x05）	0x06 0x05	记录错误日志且不崩溃
错误EventID（0x07）	0x07 0x03	丢弃数据包并报错

事件触发场景
- 当蓝牙配件（如耳机、音箱）连接的媒体播放器发生电源状态变化，或配件与主机物理断开时触发。
- 示例场景：
  - 蓝牙音箱被用户手动关闭电源 → 发送 POWER_OFF (0x01)。
  - 蓝牙耳机从播放器底座拔出 → 发送 UNPLUGGED (0x02)。
状态值定义
- POWER_ON (0x00)：设备已通电并正常运行。
- POWER_OFF (0x01)：设备主动关机（如低电量保护或用户操作）。
- UNPLUGGED (0x02)：设备物理断开连接（如从充电底座移除或蓝牙适配器拔出）。
协议细节
- 数据包总长度为 2字节，按顺序依次为 EventID 和 SystemStatus。
- 字节序默认采用大端（Big-Endian），单字节参数无需考虑顺序问题。
应用建议
- 开发者实现：
  - 解析事件时，首先校验 EventID 是否为 0x07，再读取 SystemStatus。
  - 对 UNPLUGGED 状态，需主动释放蓝牙连接资源并更新用户界面提示。
- 错误处理：
  - 若收到非定义值（如 0x03），记录日志并忽略，避免协议解析崩溃。

⑦EVENT_SYSTEM_STATUS_CHANGED

事件触发场景
- 当蓝牙配件（如耳机、音箱）连接的媒体播放器发生电源状态变化，或配件与主机物理断开时触发。
- 示例场景：
  - 蓝牙音箱被用户手动关闭电源 → 发送 POWER_OFF (0x01)。
  - 蓝牙耳机从播放器底座拔出 → 发送 UNPLUGGED (0x02)。
状态值定义
- POWER_ON (0x00)：设备已通电并正常运行。
- POWER_OFF (0x01)：设备主动关机（如低电量保护或用户操作）。
- UNPLUGGED (0x02)：设备物理断开连接（如从充电底座移除或蓝牙适配器拔出）。
协议细节
- 数据包总长度为 2字节，按顺序依次为 EventID 和 SystemStatus。
- 字节序默认采用大端（Big-Endian），单字节参数无需考虑顺序问题。
应用建议
- 开发者实现：
  - 解析事件时，首先校验 EventID 是否为 0x07，再读取 SystemStatus。
  - 对 UNPLUGGED 状态，需主动释放蓝牙连接资源并更新用户界面提示。
- 错误处理：若收到非定义值（如 0x03），记录日志并忽略，避免协议解析崩溃。

⑦EVENT_PLAYER_APPLICATION_SETTING_CHANGED

事件触发场景：当播放器（TG, Target）的应用设置（如音效、循环模式、随机播放等）发生变更时，由设备主动通知控制器（CT, Controller）。
- 示例场景：
  - 用户通过播放器切换音效模式 → 触发事件并发送新的音效属性值。
  - 系统自动关闭循环播放 → 返回循环模式属性及更新后的值。
协议细节
- 数据包结构：
  - 总长度为 2 + 2*N 字节（EventID 1字节 + N 1字节 + 每组属性ID和值各1字节）。
  - 数据按顺序排列：EventID → N → AttributeID_1 → ValueID_1 → ... → AttributeID_N → ValueID_N。
- 属性与值定义：属性ID（如 0x01 表示循环模式）与值ID（如 0x00 表示关闭循环）需参考下表。

兼容性要求：每次事件触发时，播放器需返回所有当前有效设置（即使仅部分设置变更），以便控制器同步完整状态。
状态同步机制
- 控制器需维护本地播放器设置的缓存，通过对比新旧属性值列表，识别具体变更项。
- 若收到未定义的属性ID或值ID，应记录警告日志并忽略无效数据。

示例数据

单属性变更（如音效模式切换为“摇滚”）：
```
0x08 0x01 0x02 0x03
```
- 0x08: EventID
- 0x01: N=1（1组属性）
- 0x02: 属性ID=2（假设为音效模式）
- 0x03: 值ID=3（假设为“摇滚”）
多属性变更（如循环模式关闭 + 随机播放开启）：

0x08 0x02 0x01 0x00 0x03 0x01

0x08: EventID
0x02: N=2（2组属性）
0x01 0x00: 属性ID=1（循环模式）→ 值ID=0（关闭）
0x03 0x01: 属性ID=3（随机播放）→ 值ID=1（开启）

应用建议

开发者实现：
- 解析事件时，先读取 EventID 校验是否为 0x08。
- 读取 N 值后，循环解析后续的 N 组属性与值。
- 对比本地缓存的属性列表，更新变更项并触发业务逻辑（如刷新UI、同步状态到其他设备）。
错误处理：
- 若 N=0 或超过协议定义范围（1-255），视为无效数据并丢弃。
- 若属性ID或值ID未定义，记录警告日志并跳过该组数据。

3.4 协议实现的 5 大陷阱

①字节序混淆：所有多字节参数使用 网络字节序（大端）

▶ 错误使用小端序解析多字节数据

▶ 解：使用协议专用解析库

from avrcp_parser import BigEndianStruct as bes
pos = bes.unpack('I', data[1:5])[0]

②事件覆盖问题：

▶ 同一EventID重复注册会覆盖前一个监听

▶ 解：维护已注册事件列表，避免重复注册

// 错误：两次注册相同事件
register(EVENT_TRACK_CHANGED);
register(EVENT_TRACK_CHANGED); // 覆盖前一个

③播放间隔误用：

▶ 非0x05事件设置interval参数无效

▶ 解：动态屏蔽非位置事件的interval参数

// 无效但合法：电池事件带间隔参数
new RegisterNotification(EVENT_BATT, interval=5);

④特殊值处理遗漏：

▶ 未处理0xFFFFFFFF导致显示错误

▶ 解：增加全局值域检查函数

bool is_valid_position(uint32_t pos) {
    return pos != 0xFFFFFFFF;
}

⑤未实现重注册机制：

▶ TRACK_REACHED_END 触发后未重新注册导致后续事件丢失

▶ 解：建立事件-回调自动重注册映射表

void onTrackEnd() {
    playNext();
    // 必须重新注册
    registerNotification(EVENT_TRACK_REACHED_END); 
}

⑥超时未处理

▶ 未在TMTP时间内收到INTERIM响应

▶ 解：实现响应计时器

private ScheduledExecutorService responseTimer = Executors.newScheduledThreadPool(1);
void sendCommandWithTimeout(Runnable onTimeout) {
    responseTimer.schedule(onTimeout, 200, TimeUnit.MILLISECONDS);
}

四、GetPlayStatus和RegisterNotification的协同策略

策略	RegisterNotification	GetPlayStatus	最佳实践
初始化阶段	注册关键事件	立即查询当前状态	避免界面短暂显示旧数据
高频更新数据	订阅位置变化事件	不主动查询	降低通信负载，如进度条更新
异常恢复	重新注册失效事件	主动查询验证状态	网络中断后先查询当前状态再重新注册
低功耗场景	减少事件注册数量	按需查询	仅保留必要事件监听（如系统状态），其他数据使用时查询