Merge branch 'feature/adf_add_media_protocols_component' into 'master'

feat(esp-adf-libs): Add media protocols component See merge request adf/esp-adf-internal!1453

Author: jason-mao

components/esp-adf-libs

@@ -10,6 +10,15 @@ This example demonstrates the process of running a UPnP/DLNA media renderer in t
 
 The Digital Living Network Alliance (DLNA) aims to establish the interoperability among PCs, consumer appliances, and mobile devices in wireless networks and wired networks. The purpose is to provide a solution for sharing between digital media and content services.
 
+### Resources
+
+Memory consumption of the entire example:
+
+| Memory_total (Bytes) | Memory_inram (Bytes) | Memory_psram (Bytes) |
+|----------------------|----------------------|----------------------|
+| 271836 | 109628 | 162208 |
+
+Test is conducted using the ESP32-S3-Korvo-2 board.
 
 ## Environment Setup
 

examples/advanced_examples/dlna/README.md

@@ -10,6 +10,15 @@
 
 数字生活网络联盟 (Digital Living Network Alliance, DLNA) 旨在解决个人 PC、消费电器和移动设备在内的无线网络和有线网络的互联互通，目的是打通数字媒体和内容服务之间共享的一种解决的方案。
 
+### 资源列表
+
+示例内存消耗：
+
+| Memory_total (Bytes) | Memory_inram (Bytes) | Memory_psram (Bytes) |
+|----------------------|----------------------|----------------------|
+| 271836 | 109628 | 162208 |
+
+测试使用 ESP32-S3-Korvo-2 开发板。
 
 ## 环境配置
 

examples/advanced_examples/dlna/README_CN.md

@@ -327,8 +327,8 @@ void app_main()
  esp_periph_config_t periph_cfg = DEFAULT_ESP_PERIPH_SET_CONFIG();
  esp_periph_set_handle_t set = esp_periph_set_init(&periph_cfg);
  periph_wifi_cfg_t wifi_cfg = {
- .wifi_config.sta.ssid = "YOUR_SSID",
- .wifi_config.sta.password = "YOUR_PASSWORD",
+ .wifi_config.sta.ssid = CONFIG_WIFI_SSID,
+ .wifi_config.sta.password = CONFIG_WIFI_PASSWORD,
  };
  esp_periph_handle_t wifi_handle = periph_wifi_init(&wifi_cfg);
  esp_periph_start(set, wifi_handle);

examples/advanced_examples/dlna/main/dlna_example.c

@@ -9,11 +9,13 @@ ESP Multi-Room Music is a Wi-Fi-based communication protocol to share music amon
 
 ### Resources
 
-Memory consumption:
+Memory consumption of the entire example:
 
-| memory_total (byte) | memory_inram (byte) | memory_psram (byte) |
-|---------------------|---------------------|---------------------|
-| 279632 | 145064 | 134568 |
+| Memory_total (Bytes) | Memory_inram (Bytes) | Memory_psram (Bytes) |
+|----------------------|----------------------|----------------------|
+| 279632 | 145064 | 134568 |
+
+Test is conducted using the ESP32-S3-Korvo-2 board.
 
 ## Environment Setup
 

examples/advanced_examples/multi-room/README.md

@@ -9,11 +9,13 @@ ESP Multi-Room Music 是一种基于 Wi-Fi 的多扬声器互联共享音乐通
 
 ### 资源列表
 
-内存消耗
+示例内存消耗：
 
-| memory_total (byte) | memory_inram (byte) | memory_psram (byte) |
-|---------------------|---------------------|---------------------|
-| 279632 | 145064 | 134568 |
+| Memory_total (Bytes) | Memory_inram (Bytes) | Memory_psram (Bytes) |
+|----------------------|----------------------|----------------------|
+| 279632 | 145064 | 134568 |
+
+测试使用 ESP32-S3-Korvo-2 开发板。
 
 ## 环境配置
 

examples/advanced_examples/multi-room/README_CN.md

@@ -7,6 +7,14 @@
 
 ESP RTC 是一个基于标准 SIP 协议的视频通话客户端，可以用于音视频通话等场景。
 
+### 资源列表
+
+示例内存消耗：
+
+|Memory_total (Bytes)|Memory_inram (Bytes)|Memory_psram (Bytes)
+|---|---|---
+|263752 |100144 |163608
+
 ## 环境配置
 
 ### 硬件要求
@@ -32,6 +40,13 @@ ESP RTC 是一个基于标准 SIP 协议的视频通话客户端，可以用于
 
  - 建议在 `conf/vars.xml` 中打开 PCMA、PCMU、VP8、H264。
 
+ - 建议关闭服务器自动应答，可以通过在 `conf/dialplan/default.xml` 中设置 `<action application="export" data="sip_auto_answer=false"/>` 来关闭。
+
+ - 建议关闭服务器强制应答，可以通过在 `conf/dialplan/default.xml` 中注释以下三行来关闭。
+ `<action application="answer"/>`
+ `<action application="sleep" data="1000"/>`
+ `<action application="bridge" data="loopback/app=voicemail:default ${domain_name} ${dialed_extension}"/>`
+
 - 我们建议搭建 Freeswitch 服务器来测试。
 
 ## 编译和下载

examples/protocols/esp-rtc/README_CN.md

@@ -77,6 +77,9 @@ static int _esp_rtc_event_handler(esp_rtc_event_t event, void *ctx)
  av_video_enc_stop(av_stream);
  av_video_dec_stop(av_stream);
  break;
+ case ESP_RTC_EVENT_CALL_ANSWERED:
+ ESP_LOGI(TAG, "ESP_RTC_EVENT_CALL_ANSWERED");
+ break;
  case ESP_RTC_EVENT_HANGUP:
  ESP_LOGI(TAG, "ESP_RTC_EVENT_HANGUP");
  break;

examples/protocols/esp-rtc/main/rtc_service.c

@@ -16,6 +16,16 @@ ESP RTSP 是一个基于标准 RSTP 协议的客户端和服务器。
 3. 支持作为 RTSP Player，将服务器的 RTSP 流拉下来进行播放。
  - 串口输入: ``` start 2 rtsp://192.168.1.1:554/live ```
 
+### 资源列表
+
+示例内存消耗：
+
+|Memory_total (Bytes)|Memory_inram (Bytes)|Memory_psram (Bytes)
+|---|---|---
+|241364 |97744 |143620
+
+测试使用 ESP32-S3-Korvo-2 开发板，示例模式选择为 Server。
+
 ## 环境配置
 
 ### 硬件要求

examples/protocols/esp-rtsp/README_CN.md

@@ -32,6 +32,19 @@
 static const char *TAG = "RTSP_SERVICE";
 
 static esp_rtsp_mode_t rtsp_mode;
+static uint32_t stream_first_pts;
+
+static uint32_t get_cur_pts()
+{
+ uint32_t cur_pts = 0;
+ if (stream_first_pts == 0) {
+ stream_first_pts = esp_timer_get_time() / 1000;
+ cur_pts = 0;
+ } else {
+ cur_pts = esp_timer_get_time() / 1000 - stream_first_pts;
+ }
+ return cur_pts;
+}
 
 static char *_get_network_ip()
 {
@@ -49,6 +62,7 @@ static int _esp_rtsp_state_handler(esp_rtsp_state_t state, void *ctx)
  ESP_LOGI(TAG, "RTSP_STATE_SETUP");
  break;
  case RTSP_STATE_PLAY:
+ stream_first_pts = 0;
  if (rtsp_mode == RTSP_CLIENT_PLAY) {
  av_audio_dec_start(av_stream);
  } else {
@@ -58,6 +72,7 @@ static int _esp_rtsp_state_handler(esp_rtsp_state_t state, void *ctx)
  ESP_LOGI(TAG, "RTSP_STATE_PLAY");
  break;
  case RTSP_STATE_TEARDOWN:
+ stream_first_pts = 0;
  if (rtsp_mode == RTSP_CLIENT_PLAY) {
  av_audio_dec_stop(av_stream);
  } else {
@@ -70,7 +85,7 @@ static int _esp_rtsp_state_handler(esp_rtsp_state_t state, void *ctx)
  return 0;
 }
 
-static int _send_audio(unsigned char *data, int len, void *ctx)
+static int _send_audio(unsigned char *data, int len, uint32_t *pts, void *ctx)
 {
  av_stream_handle_t av_stream = (av_stream_handle_t) ctx;
  av_stream_frame_t frame = {0};
@@ -79,6 +94,8 @@ static int _send_audio(unsigned char *data, int len, void *ctx)
  if (av_audio_enc_read(&frame, av_stream) < 0) {
  return 0;
  }
+ /* av_stream pts out of sync, use system pts instead */
+ *pts = get_cur_pts();
  return frame.len;
 }
 
@@ -91,7 +108,7 @@ static int _receive_audio(unsigned char *data, int len, void *ctx)
  return av_audio_dec_write(&frame, av_stream);
 }
 
-static int _send_video(unsigned char *data, unsigned int *len, void *ctx)
+static int _send_video(unsigned char *data, unsigned int *len, uint32_t *pts, void *ctx)
 {
  av_stream_handle_t av_stream = (av_stream_handle_t) ctx;
  av_stream_frame_t frame = {0};
@@ -101,6 +118,8 @@ static int _send_video(unsigned char *data, unsigned int *len, void *ctx)
  return ESP_FAIL;
  }
  *len = frame.len;
+ /* av_stream pts out of sync, use system pts instead */
+ *pts = get_cur_pts();
  return ESP_OK;
 }