Subscribe Audio - IoT SDK

The Audio subscribing feature allows IoT devices to receive and render audio streams from other participants in a meeting. This enables real-time playback of audio from remote peers in your VideoSDK-powered applications.

Supported hardware

Playback needs a board with a speaker; without one, startSubscribeAudio() returns DEVICE_NOT_SUPPORTED. See Supported Microcontrollers for which boards support this.

startSubscribeAudio()

• The startSubscribeAudio() function lets your device receive and play audio from the other participants in the meeting.

• This function takes no parameters. The participant identity comes from the participantId you set once in init().

note

• You must call the init() method before invoking startSubscribeAudio(). If not, the function will return an INIT_NOT_CALLED result code.

• Only one subscribe task can run at a time. If another subscribe task is already active, calling this function again will result in a TASK_ALREADY_STARTED result code.

• There is no separate stop call. leave() tears down all publishing and subscribing when you exit the meeting.

caution

The participantId must be unique for each participant in the meeting. If you leave it as NULL or an empty string in init(), the SDK generates a unique one for you.

Example

#include "videosdk.h"
#include "esp_log.h"

void app_main() {
  // Ensure init() is called before this
  result_t subscribe_result = startSubscribeAudio();
  ESP_LOGI("IOT-SDK", "Subscribe Result: %d", subscribe_result);
}

API Reference

The API references for all the methods utilized in this guide are provided below.

• startSubscribeAudio