花了3个小时解决了和异地女朋友一起看电影的需求(内附源码)

一、这是一件悲伤的故事

我是一名程序员，我和我的女友是异地恋，so sad！！！

一次视频时，她突然来了一句：“我们已经很久没有一起看电影了吧。。。。。。”

“呃。。。好像是”，毕竟离得那么远，一起看电影有点难啊。

女友“哦”了下，我们便陷入了沉默。

视频结束，心情有点忧伤。是啊，已经很久没有好好陪她了吧。

突然想到市面上有不少可以一起看电影的APP。找了下，确实不少，像微光之类的 APP 人气都很火。下载了一个，发现还是挺有意思的，确实能解决异地一起看电影的需求。

于是“啪”的一下，灵光一现，哄女友开心的方法有了，哦耶！！！我可以自己去实现一个 demo 呀！

作为一名优质的程序员，鉴于职业探索精神以及在 ZEGO 即构科技的从业经验，想到实现一个类似功能的 demo 还是很可以的。

说干就干，熬夜小 case，通宵搞出了demo，效果如下：

前面铺设了这么长，相信你们也不是来看我晒狗粮的（狗头保命）。那么现在就和我一起来看看我是怎么实现这个让女朋友欢心的“一起看电影”的功能吧，文章有点长，但是绝对很干货，大家可以耐心看完。

二、开始准备

在开始实现一起看电影的demo之前，我们需要做一些开发前的准备工作：

01 开发环境准备

首先第一步就是准备开发环境，需要确保开发环境满足以下要求：

Android Studio 2.1 或以上版本。
Android SDK 25、Android SDK Build-Tools 25.0.2、Android SDK Platform-Tools 25.x.x 或以上版本。
Android 4.1 或以上版本，且支持音视频的 Android 设备。
Android 设备已经连接到 Internet。

02 账户注册

开发环境搭建好之后，我们需要去 ZEGO 官网注册一个账户，进入管理控制台并创建应用、获取开发需要的 AppId 和 AppSign 。

具体的创建应用过程详见此文章： 控制台创建项目流程。

三、实现流程介绍

01 接口规范说明

首先分析 ZEGO 的 API 输入输出规范。根据 API使用文档来看，调用接口格式如下：

以创建 ZegoExpressEngine 单列对象为列，每个参数都详细的解析其作用。每个接口都描述了作用与用法。

02 一起看电影的项目开发

接下来就万事俱备了，跟着我来着手实操一下，看具体怎么实现一起看电影的项目。

项目分为两部分：播放本地电影的服务端、拉流播放电影的客户端。下面会进行每个部分的详细介绍。

项目设置了最大用户数为3人，服务端占了一位，所以客户端只能同时两人在线观看电影（悄咪咪，确保你们两个人之间不会出现第三者）。

1、服务端 —— 播放电影服务端的实现流程

步骤一：创建 ZegoExpressEngine 引擎：

/** 定义 SDK 引擎对象 */ZegoExpressEngine engine; /** 填写 appID 和 appSign */long appID = ; /** 请通过官网注册获取，格式为 123456789L */String appSign = ; /** 64个字符，请通过官网注册获取，格式为"0123456789012345678901234567890123456789012345678901234567890123" *//** 创建引擎，使用测试环境，通用场景接入 */engine = ZegoExpressEngine.createEngine(appID, appSign, true, ZegoScenario.GENERAL, getApplication, );

步骤二：开启自定义视频采集功能：

ZegoCustomVideoCaptureConfig videoCaptureConfig = new ZegoCustomVideoCaptureConfig;// 选择 RAW_DATA 类型视频帧数据videoCaptureConfig.bufferType = ZegoVideoBufferType.RAW_DATA; engine.enableCustomVideoCapture(true, videoCaptureConfig, ZegoPublishChannel.MAIN);

步骤三：设置自定义视频采集回调对象并实现对应方法：

// 将自身作为自定义视频采集回调对象 sdk.setCustomVideoCaptureHandler(new IZegoCustomVideoCaptureHandler {  @Override  public void onStart(ZegoPublishChannel channel) {  // 收到回调后，开发者需要执行启动视频采集相关的业务逻辑，例如开启摄像头等 ...  }  @Override  public void onStop(ZegoPublishChannel channel) {  // 收到回调后，开发者需要执行停止视频采集相关的业务逻辑，例如关闭摄像头等 ...  } });

步骤四：选择要播放的电影，设置房间ID。然后登录房间，将收到自定义视频采集回调通知开始采集：

/** 创建用户 */ ZegoUser user = new ZegoUser("user1"); 
/** 开始登录房间 */ engine.loginRoom("room1", user);

mZegoMediaPlayer.setVideoHandler(new IZegoMediaPlayerVideoHandler { @Override public void onVideoFrame(ZegoMediaPlayer zegoMediaPlayer, ByteBuffer[] byteBuffers, int[] ints, ZegoVideoFrameParam zegoVideoFrameParam) { }}, ZegoVideoFrameFormat.RGBA32);

步骤五：当客户端发送通知开始播放电影，就开始推流(电影流)，预加载load 电影，开始播放start

/** 开始推流 */ engine.startPublishingStream("stream1");

mZegoMediaPlayer.loadResource(path, new IZegoMediaPlayerLoadResourceCallback { @Override public void onLoadResourceCallback(int code) { if (code == 0) { mZegoMediaPlayer.start; if (callback != ) { callback.onLoadResourceCallback(code); } } }});

步骤六：调用发送视频帧方法 sendCustomVideoCaptureRawData 向 SDK 提供视频帧数据。

// 将采集的数据传给ZEGO SDKint totalDataLength = byteBuffers[0].capacity;if (tempByteBuffer ==  || tempByteBuffer.capacity != totalDataLength) { tempByteBuffer = ByteBuffer.allocateDirect(byteBuffers[0].capacity).put(byteBuffers[0]);} else { tempByteBuffer.clear; tempByteBuffer.put(byteBuffers[0]);}ZegoSDKManager.getInstance.getStreamService.sendCustomVideoCaptureRawData(tempByteBuffer, tempByteBuffer.capacity, zegoVideoFrameParam);

步骤七：当客户端没有观众在房间或者服务器退出播放房间，结束推流将收到自定义视频采集回调通知停止采集。

2、客户端——拉流播放电影客户端的实现流程

首先，播放电影的客户端分别有以下几项功能：

A、B 端观众的电影拉流渲染、电影播放暂停。
A、B 端观众音视频的推拉流、摄像头的翻转开关、麦克风的开关。
A、B 端观众的房间实时消息的发送接收。

接下来，我们将根据上述提到的具体功能展开为大家介绍：

（1）针对于电影播放功能的流程介绍

A 端观众通过后台设置的 RoomID 成功登录房间，如果输入的 RoomID 不存在，就会通过判断当前 A 端是房间内第一人，退出房间提示房间不存在；或者房间内已经满员就会登录失败并提示房间已满员。

* 点击电影播放按钮 setRoomExtraInfo 进行消息的通知
* 后台手机端收到 onRoomExtraInfoUpdate 的回调进行电影的播放
* 观众端会收到电影播放的推流，获取电影推流 StreamID 进行拉流播放
B 端通过输入 RoomID 进入播放房间，进行电影的拉流显示：

/** * 开始拉流，设置远端拉流渲染视图，视图模式采用 SDK 默认的模式，等比缩放填充整个 View * 如下 play_view 为 UI 界面上的 SurfaceView/TextureView/SurfaceTexture 对象 */ engine.startPlayingStream("stream1", new ZegoCanvas(play_view));

AB端观众都可以通过 setRoomExtraInfo(String roomID,String key,String value,) 来对视频媒体进行播放/暂停。

AB端观众都可以通过 setRoomExtraInfo(String roomID,String key,String value,) 来对视频媒体进行播放/暂停。

一起看电影 setRoomExtraInfo 的参数意义如下：

key: roomInfo
value: 0 、1、2、3
0: 代表load start 电影
1:电影是播放状态
2:电影是暂停状态
3:房间已经被关闭

（2）针对于音视频推拉流的过程

通过 ZEGO 音视频服务进行推拉流
A端观众进入房间后，向 ZEGO 音视频云服务推流，需要自己生成唯一的 StreamID ，然后开始预览并推流。等到B端观众进入房间后，会收到SDK 的流更新通知，从中筛选出 B端观众流 StreamID 进行拉流
B端观众进入房间后，向 ZEGO 音视频云服务推流，需要自己生成唯一的 StreamID ，然后开始预览并推流。同时筛选出 A端观众流 StreamID 进行拉流
AB端观众可以各自控制自己的翻转摄像头、开/关摄像头、开/关麦克风的功能：

//切换前后摄像头 front 是否采用前置摄像头；true 表示使用前置摄像头；false 表示使用后置摄像头expressEngine.useFrontCamera(front);
// 开/关摄像头 enable 是否打开摄像头；true 表示打开摄像头；false 表示关闭摄像头expressEngine.enableCamera(enable);
// 是否开启麦克风 enable 是否开启麦克风；true 表示开启麦克风；false 表示静音麦克风expressEngine.muteMicrophone(!enable);

都是跟推拉流有关，则以用户 A 拉取用户 B 的流为例，流程如下图：

想要了解更加具体的实现流程，可参考官方文档 音视频实现流程。

（3）针对于房间实时聊天消息的发送显示

AB 端观众都可以在房间内发送消息；
调用 sendBroadcastMessage 接口向同一房间内的B端观众发送广播消息，长度不能超过 1024 字节。通过 onIMSendBroadcastMessageResult 回调获取消息发送结果；

// 发送广播消息，每个登录房间的用户都会通过 onIMRecvBroadcastMessage 回调收到此消息【发送方不会收到该回调】engine.sendBroadcastMessage(roomID, msg, new IZegoIMSendBroadcastMessageCallback {  /** 发送广播消息结果回调处理 */  @Override  public void onIMSendBroadcastMessageResult(int errorCode, long messageID) {  //发送消息结果成功或失败的处理  } });

实现 IZegoEventHandler 中的 onIMRecvBroadcastMessage 回调，当发送方成功发送广播消息后，同一房间内的其他用户通过此回调接收相关信息，包括消息内容、消息 ID、发送时间及发送方信息。

/**  * 接收房间弹幕消息通知  *  * @param roomID 房间 ID  * @param messageList 收到的消息列表  */ public void onIMRecvBarrageMessage(String roomID, ArrayList messageList){  // 收到其他用户发送消息的处理 }