本页介绍通过 RTSA Lite SDK 实现码流传输涉及的 API 方法和调用流程。

1. 进行认证

RTSA 通过 License 对设备鉴权。License 与设备绑定，一个 License 在同一时间只能绑定一个设备。

自 v1.4.2 起，SDK 下载包中包含了许可证文件，因此你无需购买商用 License 即可免费试用 RTSA Lite SDK。试用时效为 90 天且存在 10 路并发限制。 如果你需要购买商用 License，请联系 sales@agora.io 或填写问卷。

调用 RTSA Lite 的其他 API 前，你需要调用 agora_rtc_license_verify方法完成认证，传入许可证 Certificate 和相应长度 certificate_len 。

示例代码如下，仅供参考：

/** ----------------PERSUDO CODE -----------------
 *  Load license files: certificate & credential
 *  Please replace it with your own implementation
 *  ----------------------------------------------
 */
app_load_license_file(certificate_file_path, str_certificate, &str_certificate_len);

int rval = agora_rtc_license_verify(str_certificate, str_certificate_len, NULL, 0);

2. 初始化和监听事件

调用 agora_rtc_init 方法初始化 RTSA 服务。

在该方法中，你需要：

• 填入获取到的 App ID 和用户 ID。只有 App ID 相同的应用程序才能进入同一个频道进行互通。
• 设置事件回调 agora_rtc_event_handler_t，用以通知 SDK 在运行过程中发生的事件。
• 设置用于存放 SDK 日志的目录（设为 null 表示使用默认目录）。

static void OnJoinChannelSuccess (const char *channel, int elapsed) {}
static void OnConnectionLost (const char *channel) {}
static void OnRejoinChannelSuccess (const char *channel, int elapsed) {}
static void OnError (const char *channel, int err, const char *msg) {}
static void OnUserJoined (const char *channel, uint32_t uid, int elapsed) {}
static void OnUserOffline (const char *channel, uint32_t uid, int reason) {}
static void OnUserMuteAudio (const char *channel, uint32_t uid, int muted) {}
static void OnUserMuteVideo (const char *channel, uint32_t uid, int muted) {}
static void OnKeyFrameGenReq (const char *channel, uint32_t remote_uid, uint8_t stream_id) {}
static void OnAudioData (const char *channel, const uint32_t uid, uint16_t sent_ts, uint8_t codec, const void *data, size_t data_len) {}
static void OnVideoData (const char *channel, const uint32_t uid, uint16_t sent_ts, uint8_t codec, uint8_t stream_id, int is_key_frame, const void *data, size_t data_len) {}
static void OnTargetBitrateChanged(const char *channel, uint32_t bps) {}

static const agora_rtc_event_handler_t listener = {
    .on_join_channel_success    = OnJoinChannelSuccess,
    .on_connection_lost         = OnConnectionLost,
    .on_rejoin_channel_success  = OnRejoinChannelSuccess,
    .on_error                   = OnError,
    .on_user_joined             = OnUserJoined,
    .on_user_offline            = OnUserOffline,
    .on_user_mute_audio         = OnUserMuteAudio,
    .on_user_mute_video         = OnUserMuteVideo,
    .on_key_frame_gen_req       = OnKeyFrameGenReq,
    .on_audio_data              = OnAudioData,
    .on_video_data              = OnVideoData,
    .on_target_bitrate_changed  = OnTargetBitrateChanged,
    // ...
};
int rval = agora_rtc_init ("YOUR_OWN_APPID", 111, &listener, NULL)

3. 加入频道

调用 agora_rtc_join_channel 方法加入频道。

在该方法中，你需要：

• 传入能标识频道的频道 ID。输入相同频道 ID 的用户会进入同一个频道。
• 传入能标识用户角色和权限的 Token 以及 Token 的大小。如果安全要求不高，使用的是 App ID，可以将 token 设为 nullptr，token 大小设为 0。

用户与频道的关系如下：

• 一个频道内的用户可以互相传输数据。
• 一个用户可以同时加入多个频道。该用户加入的所有频道都能接收到他发送的音视频数据。

成功加入频道后，SDK 会触发 on_join_channel_success 回调。

示例代码如下，仅供参考：

agora_rtc_join_channel ("YOUR_CHANNEL_NAME", str_token, str_token_len);

4. 发送/接收音视频流

成功加入频道后，可以：

• 监听 on_audio_data 回调接收所有你已加入的频道内的音频数据流。
• 监听 on_video_data 回调接收所有你已加入的频道内的视频数据流。
• 调用 agora_rtc_send_audio_data 方法向指定或所有你已加入的频道发送音频数据流。
• 调用 agora_rtc_send_video_data 方法向指定或所有你已加入的频道发送视频数据流。

示例代码如下，仅供参考：

static void OnAudioData (const char *channel, const uint32_t uid, uint16_t sent_ts, uint8_t codec, const void *data, size_t data_len)
{
    printf("invoked at %s@%d\n", __FUNCTION__, __LINE__);
    // ...
}
static void OnVideoData (const char *channel, const uint32_t uid, uint16_t sent_ts, uint8_t codec, uint8_t stream_id, int is_key_frame,
                         const void *data, size_t data_len)
{
    printf("invoked at %s@%d\n", __FUNCTION__, __LINE__);
    // ...
}

static const agora_rtc_event_handler_t listener = {
    .on_audio_data = OnAudioData,
    .on_video_data = OnVideoData,
    // ...
};


// Send audio data
audio_frame_info_t info;
info.codec = AUDIO_CODEC_AACLC;
agora_rtc_send_audio_data ("YOUR_CHANNEL_NAME", data_ptr, data_len, &info);


// Send video data
video_frame_info_t info;
info.codec = VIDEO_CODEC_H264;
info.type = is_key_frame_flag ? VIDEO_FRAME_KEY : VIDEO_FRAME_DELTA;
info.frames_per_sec = VIDEO_FRAME_RATE_FPS_30;
agora_rtc_send_video_data ("YOUR_CHANNEL_NAME", stream_id, data_ptr, data_len, &info);

5. 离开频道

调用 agora_rtc_leave_channel 方法离开指定频道，结束在该频道的数据传输。

示例代码如下，仅供参考：

agora_rtc_leave_channel ("YOUR_CHANNEL_NAME")