跳转到主要内容
用户信息查询接口返回的结构体里含有 SDK 动态分配的内存(props 字符串和 stream_tracks 数组),必须用配套的 free 接口释放,否则内存泄漏。

rtc_get_users_info

获取频道内全部用户信息。 返回值

rtc_free_users_info

释放 rtc_get_users_info 返回的用户数组,包括每个用户的 props、stream_tracks 以及数组本身。
count 必须传 rtc_get_users_info 返回的那个值。传小了会漏释放,传大了会越界。

rtc_get_user_info

获取单个用户信息。user 由调用方提供(栈上变量即可),SDK 填充其字段。 返回值

rtc_free_user_info

释放单个 rtc_user_info_t 内部的动态内存(props 和 stream_tracks),不释放结构体本身。
即使 user 是栈上变量,只要 rtc_get_user_info 返回了 RTC_OK,就必须调用一次 rtc_free_user_info。

字段说明见 类型定义 · rtc_user_info_t。

rtc_get_local_user_info

获取本端的用户信息(uid、sid 等),0.0.9 起。用完同样要调用 rtc_free_user_info。 返回值:RTC_OK / RTC_INVALID_PARAM(句柄或 user 无效)/ RTC_NOT_CONNECTED(尚未入会)。

rtc_get_channel_info

获取频道信息,0.0.9 起。字段见 类型定义 · rtc_channel_info_t。返回 RTC_OK 后必须调用 rtc_free_channel_info 释放其中的 props。 返回值:RTC_OK / RTC_INVALID_PARAM / RTC_NOT_CONNECTED(尚未入会)。