推流

---

1 功能简介

不论是在多人通话还是在秀场直播中，首先都需要推送自己的视频画面到 ZEGO 云端服务上，对端再通过从 ZEGO 云端服务上拉流，才可以获取到自己的视频画面。

2 使用步骤

2.1 设置推流回调监听

设置推流回调监听后，在调用 startPublishing 推流后，能收到推流是否成功等相关事件的通知，如果推流失败需要进行相应的错误处理。

zegoLiveRoom.setZegoLivePublisherCallback(new IZegoLivePublisherCallback(){
    // 处理推流相关的回调
    ...
});

建议处理 IZegoLivePublisherCallback 中的以下回调接口：

• onPublishStateUpdate：推流是否成功或者推流成功后流发生中断等错误导致推流失败的通知，如果推流失败（stateCode!=0），App 端提示用户推流失败或者重试推流，相关错误码请查看 推流错误码

可根据需要处理 onPublishQualityUpdate 接口，

• onPublishQualityUpdate：推流质量信息的通知，例如音视频的帧率、码率等，用于 App 展示音视频的音质、画质。

其余回调接口请根据业务实际情况进行选择处理，完整的推流回调接口请查看 IZegoLivePublisherCallback

2.2 推流设置

开始推流前，建议开发者在开始推流前对推流参数、推流视图进行设置。

设置推流参数

推流参数众多，主要包含：手机方向、美颜参数、滤镜参数、镜像、麦克风、前后置摄像头、手电筒、采集监听等等。

开发者可查阅 ZegoLiveRoom API 说明 相关内容，按需调用。

启用预览

推流前可以调用如下 API 设置预览视图、视图模式，并启动本地预览。

zegoLiveRoom.setPreviewView(view);
zegoLiveRoom.setPreviewViewMode(ZegoVideoViewMode.ScaleAspectFill);
zegoLiveRoom.startPreview();

ZegoVideoViewMode 中视图模式之间的区别请查看 ZegoVideoViewMode

2.3 开始推流

开发者可调用如下 API 进行推流，如果不需要继续推流，请调用 stopPublishing 停止推流。

zegoLiveRoom.startPublishing(streamID, title, ZegoConstants.PublishFlag.JoinPublish)

开发者也可按照实际使用场景，指定推流场景，请参考 ZegoConstants.PublishFlag 定义。

推流错误码

2.4 停止推流

调用 stopPublishing 停止推流。

停止推流不会触发退出房间，用户依然可以在当前房间中，重新推流。

zegoLiveRoom.stopPublishing()

2.5 停止预览

调用如下 API 停止预览，停止预览后，用户也无法看到自己的画面。

zegoLiveRoom.stopPreview()

3 API 参考列表

4 相关文档

完成了推流后，可以使用 ZEGO SDK 依次完成如下功能来实现基础的通话或者直播。

• 快速开始-拉流
• 进阶功能-连麦