ESP-ADF VoIP示例中获取来电号码的方法解析

在ESP-ADF音频开发框架的VoIP功能开发中，获取来电号码是一个常见需求。本文将详细分析在不同版本中获取来电号码的实现方式差异，并提供完整的解决方案。

版本差异分析

在ESP-ADF v2.4版本中，VoIP示例通过SIP事件处理机制可以直接从事件数据结构中获取来电号码。具体来说，当收到SIP_EVENT_RINGING事件时，event->data字段就包含了来电号码信息。

而在当前master分支版本中，事件处理机制有所改变，ESP_RTC_EVENT_INCOMING事件不再直接包含来电号码数据。这种架构调整可能是为了优化事件处理流程，但确实给开发者获取来电信息带来了新的挑战。

解决方案

新版本中获取来电号码的正确方法是使用esp_rtc_get_peer API函数。这个函数专门设计用于获取对端（来电方）的信息，包括来电号码等关键数据。

使用该API的基本流程如下：

1. 在事件处理函数中检测到ESP_RTC_EVENT_INCOMING事件
2. 调用esp_rtc_get_peer函数获取对端信息
3. 从返回的数据结构中提取来电号码

实现示例

以下是典型的事件处理函数实现片段：

static void rtc_event_handler(void *arg, esp_event_base_t base, int32_t id, void *data)
{
    if (id == ESP_RTC_EVENT_INCOMING) {
        esp_rtc_peer_info_t peer_info;
        esp_rtc_get_peer(&peer_info);
        
        // 获取来电号码
        const char *caller_id = peer_info.uri;
        ESP_LOGI(TAG, "来电号码: %s", caller_id);
    }
}

注意事项

1. 确保在使用esp_rtc_get_peer前已正确初始化RTC模块
2. 来电号码的格式可能因SIP服务器配置而异，建议做好字符串处理
3. 在多线程环境下使用时需注意线程安全问题
4. 对于异常情况（如获取失败）应有适当的错误处理机制

通过以上方法，开发者可以稳定可靠地在ESP-ADF VoIP应用中获取来电号码信息，实现完整的来电显示功能。