简介
AtomicLiveView 是 LiveCoreView 的轻量替代方案,专为纯播放场景设计。 它是独立管理自身渲染表面与生命周期的视图容器,不依赖 LiveCoreView。 适用于仅需视频渲染、不需要麦位 / 连麦 / PK 能力的场景。核心特性
最小视图容器:专注于纯播放场景的视频渲染。
独立容器:自管理渲染视图生命周期,不依赖
LiveCoreView。无缝集成 AtomicPlayer:将此视图传递给
AtomicPlayer 构造函数即可完成视频输出链路。数据结构
AtomicLiveViewType
AtomicLiveView 的渲染类型。
枚举值 | 说明 |
PLAY_VIEW | 播放视图,配合 AtomicPlayer 使用。 |
PUSH_VIEW | 推流视图,配合 AtomicPusher 使用。 |
UnitInfo
直播单元信息,描述渲染在 AtomicLiveView 上的单个坐席。
属性 | 类型 | 说明 |
index | Int | 单元索引。 |
liveID | String | 直播 ID。 |
userID | String | 用户 ID。 |
userName | String | 用户名称。 |
avatarURL | String | 头像 URL。 |
microphoneStatus | 麦克风状态。 | |
cameraStatus | 摄像头状态。 | |
userSuspendStatus | 用户挂起状态。 |
AtomicLiveViewChangeAdapter
AtomicLiveView 挂件适配器。业务侧通过实现该接口,按需为当前 AtomicLiveView 提供叠加层各类子 UI,并接收视频视图位置变化等回调。SDK 负责将其挂载到推流预览视图之上正确的层级,不影响底层渲染。create* 方法返回 nil 表示当前 View 不需要该类挂件。
方法
onCreateUnitView: 单元首次加入布局时构建坐席挂件视图;后续内容刷新请使用 onUpdateUnitView。
fun onCreateUnitView(unitInfo: UnitInfo?,): View?
参数名 | 类型 | 说明 |
unitInfo | 直播单元信息。 |
onUpdateUnitView: 已挂件坐席的业务字段变化时更新其挂件视图。
fun onUpdateUnitView(unitInfo: UnitInfo?,view: View?,)
参数名 | 类型 | 说明 |
unitInfo | 最新的直播单元信息。 | |
view | View? | 该坐席当前的挂件视图;若该坐席尚未创建挂件则为空。 |
onVideoViewFrameChanged: 视频视图位置变化回调。当同房连麦坐席对应的视频视图位置 / 尺寸发生变化时由 SDK 触发,业务侧可据此同步调整叠加在其上的自定义挂件布局。位置以相对父容器的比例表示,取值范围 0, 1。
fun onVideoViewFrameChanged(left: Float,top: Float,right: Float,bottom: Float,)
参数名 | 类型 | 说明 |
left | Float | 左上点距离左侧的比例。 |
top | Float | 左上点距离上侧的比例。 |
right | Float | 右下点距离左侧的比例。 |
bottom | Float | 右下点距离上侧的比例。 |
onVolumeChanged: 说话音量变化回调。当麦上用户的说话音量发生变化时由 SDK 触发,播放侧来自流中携带的音量,推流侧来自本地采集与远端连麦用户的音量。仅当该用户的音量真正发生变化时才回调。
fun onVolumeChanged(unitInfo: UnitInfo?,volume: Int,view: View?,)
参数名 | 类型 | 说明 |
unitInfo | 音量发生变化的麦位对应的直播单元信息。 | |
volume | Int | 该用户最新的说话音量,取值范围 0 ~ 100。 |
view | View? | 该麦位当前的挂件视图;若该坐席尚未创建挂件则为空。 |