写点什么

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

用户头像
ZEGO即构
关注
发布于: 20 分钟前
花了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(), null); 
复制代码


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


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 != null) {                callback.onLoadResourceCallback(code);            }        }    }});
复制代码


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


// 将采集的数据传给ZEGO SDKint totalDataLength = byteBuffers[0].capacity();if (tempByteBuffer == null || 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,null) 来对视频媒体进行 播放/暂停。

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


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


  1. key: roomInfo

  2. value:  0 、1、2、3

  3. 0: 代表 load start 电影

  4. 1:电影是播放状态

  5. 2:电影是暂停状态

  6. 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<ZegoBarrageMessageInfo> messageList){             // 收到其他用户发送消息的处理     }
复制代码


  • 发送接收到的消息显示到 UI 界面。


四、效果呈现(附 demo 源码下载)

01 播放电影端的效果图

(电影播放端)

02 观众端的效果图


(电影观众端)



(电影播放时示意图)


附上 demo 给大家进行体验,一起看电影一共分为两部分,安装密码为 1:


1)服务端 demo : 看电影服务端


2)客户端 demo :   一起看电影


安装方式如下:


1)先启动 服务端 demo ,选择电影设置房间 ID;


2)客户端 demo 通过输入设置的房间 ID 进入播放电影房。


源码下载: 百度网盘 请输入提取码(密码:qrep)


五、结语


牛顿曾说:我看得远,是因为我站在巨人的肩膀上!


基于 ZEGO 即构科技的音视频功能,一番操作下来,很简单就开发出来一款《一起看电影》的 demo,总体来说还是很简单就可以实现的。


让异地恋女友开心的方法近在咫尺,赶快行动起来体验音视频开发的乐趣吧!



发布于: 20 分钟前阅读数: 11
用户头像

ZEGO即构

关注

专注音视频领域19年 2020.04.15 加入

全球领先的音视频云服务商,已为映客、酷狗、喜马拉雅、荔枝、好未来、作业帮、掌门一对一、Live.Me、UpLive、Mico、平安科技等众多行业头部企业提供音视频云服务。

评论

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