功能实现流程

架构设计

音视频通话场景的主要架构如下图所示：

示例源码

ZEGO 针对视频通话场景提供了示例源码，以供开发者进一步体验相关场景，了解 ZEGO 方案。

前提条件

在实现基本的音视频通话前，请确保：

已在项目中集成 ZEGO Express SDK，详情请参考快速开始 - 集成。
已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 - 项目管理中的“项目信息”。

实现流程

音视频通话场景的整体流程如下：

所有用户均通过信令模块进行连接，信令模块可以控制当前业务房间内的通话流程，同步并通知各端当前的通话状态。
无论用户是否在加入房间，均通过 ZEGO 音视频云服务进行推拉流。
用户开始推流后，房间内所有用户将会接收到流更新通知，并拉取新进来的用户的音视频流。
若用户需要结束通话，则向信令模块发起结束推流请求，房间内的其他用户也收到停止拉流信号。

多用户推拉流详细流程图如下：

提示

以下章节主要针对核心源码片段进行说明。

初始化 SDK

初始化 Express SDK

在使用 Express Video SDK 进行视频通话之前，需要初始化 SDK。由于初始化操作 SDK 时，内部处理的操作较多，建议开发者在进入页面的时候进行。

ZegoEngineProfile *profile = [[ZegoEngineProfile alloc] init];
profile.appID = appID;
profile.appSign = appSign;
ZegoExpressEngine *express = [ZegoExpressEngine createEngineWithProfile:profile eventHandler:self];

ZegoEngineProfile *profile = [[ZegoEngineProfile alloc] init];
profile.appID = appID;
profile.appSign = appSign;
ZegoExpressEngine *express = [ZegoExpressEngine createEngineWithProfile:profile eventHandler:self];

更多初始化 SDK 的细节请参考：快速开始 - 实现流程的 “初始化”。

开始音视频通话

登录房间

用户在进行音视频通话前，需要先登录到房间，在收到登录房间成功的回调之后可以直接调用 SDK 的接口进行推拉流操作。

ZegoRoomConfig *config = [[ZegoRoomConfig alloc] init];
config.maxMemberCount = 4; // 最大用户数
config.isUserStatusNotify = YES;

NSString *roomID = @"12345678901"; // 必填，房间 ID，建议开发者在自己的后台生成，最大长度为 128 字节的字符串。仅支持数字、英文字符和 '~', '!', '@', '#', '$', '', '^', '&', '*', '(', ')', '_', '+', '=', '-', ', ';', '’', ',', '.', '<', '>', '/'。
ZegoUser *user = [ZegoUser userWithUserID:userID userName:userName];
// 登录房间
[self.express loginRoom:roomID user:user config:config];

ZegoRoomConfig *config = [[ZegoRoomConfig alloc] init];
config.maxMemberCount = 4; // 最大用户数
config.isUserStatusNotify = YES;

NSString *roomID = @"12345678901"; // 必填，房间 ID，建议开发者在自己的后台生成，最大长度为 128 字节的字符串。仅支持数字、英文字符和 '~', '!', '@', '#', '$', '', '^', '&', '*', '(', ')', '_', '+', '=', '-', ', ';', '’', ',', '.', '<', '>', '/'。
ZegoUser *user = [ZegoUser userWithUserID:userID userName:userName];
// 登录房间
[self.express loginRoom:roomID user:user config:config];

更多使用 SDK 实现登录房间的细节请参考：快速开始 - 实现流程的 “登录房间”。

开始推拉流

开始推流

用户向 ZEGO 音视频云服务推流，需要自己生成唯一的 streamID，然后开始预览并推流。

// 设置本地预览视图并启动预览，视图模式采用 SDK 默认的模式，等比缩放填充整个 View
ZegoCanvas *canvas = [ZegoCanvas canvasWithView:view];
[self.express startPreview:canvas];

// 创建流
NSString *streamID = @"my_stream_id"; // 推流 ID，建议开发者在自己的后台生产，长度不超过 256 的字符串，仅支持数字、英文字符和 "-"、"_"。
// 开始推流
[self.express startPublishingStream:streamID];

// 设置本地预览视图并启动预览，视图模式采用 SDK 默认的模式，等比缩放填充整个 View
ZegoCanvas *canvas = [ZegoCanvas canvasWithView:view];
[self.express startPreview:canvas];

// 创建流
NSString *streamID = @"my_stream_id"; // 推流 ID，建议开发者在自己的后台生产，长度不超过 256 的字符串，仅支持数字、英文字符和 "-"、"_"。
// 开始推流
[self.express startPublishingStream:streamID];

更多使用 SDK 实现预览和推流的细节请参考：快速开始 - 实现流程的 “预览自己的画面，并推送到 ZEGO 音视频云”。

开始拉流

用户进入房间后，会收到 SDK 的流更新通知，根据获取到的 streamID 进行拉流。

// 拉流
NSString *playStreamID = @"play_stream_id"; // 流 ID
ZegoCanvas *canvas = [ZegoCanvas canvasWithView:view];
[self.express startPlayingStream:streamID canvas:canvas];

// 拉流
NSString *playStreamID = @"play_stream_id"; // 流 ID
ZegoCanvas *canvas = [ZegoCanvas canvasWithView:view];
[self.express startPlayingStream:streamID canvas:canvas];

更多使用 SDK 实现拉流的细节请参考：快速开始 - 实现流程的 “拉取其他用户的音视频”。

结束音视频通话

停止推拉流

停止推流

用户需要结束音视频通话时，向 ZEGO 音视频云服务发送结束推流，调用成功后，ZEGO 音视频云服务向房间内其他所有用户发送该用户结束推流信令。房间内其他用户收到信令后停止推流。

// 停止推流
[self.express stopPublishingStream];

// 停止推流
[self.express stopPublishingStream];

更多使用 SDK 实现停止推流的细节请参考：快速开始 - 实现流程的 “停止音视频通话”。

停止拉流

房间内用户结束推流后，房间内其他所有用户会收到 SDK 的流更新通知，并根据 streamID 进行停止拉流。

// 停止拉流
[self.express stopPlayingStream:streamID];

// 停止拉流
[self.express stopPlayingStream:streamID];

更多使用 SDK 实现停止拉流的细节请参考：快速开始 - 实现流程的 “停止音视频通话”。

退出房间

// 退出房间
[self.express logoutRoom];

// 退出房间
[self.express logoutRoom];

进阶功能

实时消息互动

ZEGO 支持在视频通话中加入实时消息互动，实时展示房间内的消息，例如发消息、进退房提示、互动通知等。有关实现实时消息互动的流程，详情请参考实时消息互动。

美颜美型

基于 AI 美颜服务，提供美白、磨皮、锐化、红润等基础的美颜功能，支持大眼、瘦脸、小嘴、亮眼、白牙、瘦鼻等美型效果，打造独特自然的直播效果。

集成 SDK

如果您的项目需要实现美颜美型效果，需要先向项目集成 ZegoEffects SDK，详情请参考集成 SDK 。

导入资源和模型

在使用 ZegoEffects SDK 提供的 AI 功能前，您需要先导入 AI 资源或模型，详情请参考导入资源和模型。

在线鉴权

在使用 ZegoEffects SDK 的 AI 功能前，您需要完成在线鉴权，详情请参考在线鉴权。