vcloudLive

来自于:开发者

requestMediaCapturerAccess pushLiveInit startLive stopLive closeLive startMusic stopMusic switchCamera switchFlash filterType

概述

vcloudLive模块,实现了iOS、安卓平台集成网易视频云直播SDK模块。

网易视频云接入

申请步骤

一、注册

1.进入网易视频云首页,点击“注册”进入注册流程。

2.支持手机及邮箱两种注册方式(网易通行证用户可直接登录),如图:

描述

二、服务开通

1.注册登录后,打开管理控制台,如图: 描述

2.用户基本信息完善后可点击“申请开通”,进入到服务开通申请页(以云直播申请开通为例),选择计费方式并提交申请,如图: 描述

3.提交申请后,管理控制台页中的状态更新为后台审核中,可联系客服以加快审核流程: 描述

4.后台审核通过,服务开通成功,如图: 描述

三、直播管理

1.在服务概况中,用户可以通过操作来对计费方式进行更改,以及能够浏览到关于直播的相关信息,如图: 描述

2.点击“管理控制台”进入频道管理,在频道管理页面中,您可以查看当前直播频道的情况。包括频道名称、ID、创建时间、频道状态和操作等等。可以对直播名称进行搜索,也可以批量对直播频道进行暂停、恢复和删除。直播频道建立后,将出现在频道列表中。

2.1 在频道管理页中点击“新建”按钮,输入频道名称;频道类型:当前默认RTMP类型,后期会有其他类型可选择;点击保存按钮,页面跳转至频道列表页 描述

2.2 频道状态共有“空闲”、“直播中”、“直播录制中”和“禁用”四种状态。

2.3 点击频道列表操作下的“地址”,显示1条RTMP推流地址和HTTP、HLS、RTMP3条拉流地址。使用直播推流SDK或Demo输入推流地址即可开始直播推流,使用播放器SDK或Demo输入拉流地址(任意一条拉流地址)即可收看直播。

描述

2.4 点击频道列表操作下的“录制”,可以修改此频道的录制配置,如是否开启直播时自动录制、录制视频的名称、录制视频的默认格式及切片的长度等,直播录制一律存放到云点播服务器,因此使用直播录制功能必须先开通云点播VOD服务。

描述

四、点播管理

1 点击“视频上传”,从本地添加待上传的视频,上传前可以修改视频名称、视频分类及转码模板,修改完后点击“上传视频”即开始上传视频,上传成功后视频存放到网易视频云存储服务器,如选择了转码模板,上传成功后系统自动按照对应模板格式进行转码处理,转码处理需要消耗一定的时间。

描述

2 点击“视频管理”,显示已经成功上传的视频列表及信息,其中“视频ID”为视频唯一标识。“占用空间”表示该视频下的源视频和转码后的所有视频相加的存储量。视频状态共有“正常”、“转码中”、“转码失败”及“屏蔽”等四种状态,“屏蔽”表示该视频无法被点播及下载。可以对“正常”状态的视频作重新转码、屏蔽、删除、设置分类等操作,对“屏蔽”状态下的视频只能做恢复和删除视频处理。

描述

点击“地址”,该视频的源视频及所有转码视频都会显示单独的地址,可以作复制地址、web预览播放、下载及删除等操作,其中源视频在“地址”页下无法删除,需回到“视频管理”页删除,删除源视频即同时删除所有转码视频。

描述

3 点击“转码设置”,显示转码模板列表及信息,其中默认模板为不作任何转码处理,也不可对其做编辑和删除操作。每个模板会显示所有的转码格式及清晰度。

描述

4 点击“新建”可创建新的转码模板,共有标清MP4、FLV、HLS,高清MP4、FLV、HLS,超清MP4、FLV、HLS等9种转码格式可选。

描述

5 点击“分类设置”,显示分类列表及信息,其中默认分类不可编辑和删除。可以创建新的分类,删除非默认分类的分类,该分类下的文件不会删除,只会转移到默认分类下。

描述

模块接口

requestMediaCapturerAccess

监测当前app的麦克风,以及摄像头权限都是打开状态中

requestMediaCapturerAccess(callback(ret, err))

示例代码

  1. var obj = api.require('vcloudLive');
  2. obj.requestMediaCapturerAccess(function(ret, err) {
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本

pushLiveInit

直播初始化。由于网易直播sdk的问题,Android 只能全屏直播。

pushLiveInit({params}, callback(ret, err))

params

x:

  • 类型:数字类型
  • 描述:(必填项)模块左上角的 x 坐标(相对于所属的 Window 或 Frame);iOS 有效;
  • 默认值:0

y:

  • 类型:数字类型
  • 描述:(必填项)模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认:0;iOS 有效;
  • 默认值:0

w:

  • 类型:数字类型
  • 描述:(可选项)模块的宽度;默认:所属的 Window 或 Frame 的宽度;iOS 有效;

h:

  • 类型:数字类型
  • 描述:(可选项)模块的高度;默认:所属的 Window 或 Frame 的高度;iOS 有效;
  • 默认值:300

orientation:

  • 类型:数字类型
  • 描述:(可选项)推流视频方向;1:PORTRAIT 2:UPDOWN 3:RIGHT 4:LEFT。
  • 默认值:1

cameraPosition:

  • 类型:数字类型
  • 描述:(可选项)开启前置或者后置摄像头;1:FRONT 2:BACK。
  • 默认值:1

bitrate:

  • 类型:数字类型
  • 描述:(可选项)推流的视频流比特率。
  • 默认值:500000

fps:

  • 类型:数字类型
  • 描述:(可选项)推流的视频帧率。
  • 默认值:24

fixedOn:

  • 类型:字符串
  • 描述:(可选项)模块所属 Frame 的名字,若不传则模块归属于当前 Window

fixed:

  • 类型:布尔
  • 描述:(可选项)模块是否随所属 Window 或 Frame 滚动
  • 默认值:true(不随之滚动)

streamingQuality:

  • 类型:布尔
  • 描述:(可选项)视频质量;1:LOW低清 352288 2:MEDIUM标清 480360 3:HIGH高清 640480 4:SUPER高清 960540
  • 默认值:3

videoRenderMode:

  • 类型:字符串
  • 描述:(可选项)设置推流视频显示模式;1:采集多大分辨率,则显示多大分辨率 2:设置为16:9模式
  • 默认值:2

filterOn:

  • 类型:布尔
  • 描述:(可选项)是否开启滤镜
  • 默认值:true

pushUrl:

  • 类型:字符串
  • 描述:(必填项)网易云信的推流地址

示例代码

  1. var demo = api.require('vcloudLive');
  2. demo.pushLiveInit({
  3. x: 0,
  4. y: 0,
  5. h: 250,
  6. fixedOn: api.frameName,
  7. fixed: true,
  8. orientation: 1,//1 PORTRAIT 2 UPDOWN 3 RIGHT 4 LEFT
  9. cameraPosition: 1,//1 FRONT 2 BACK
  10. bitrate: 500000,//码率
  11. fps: 24,//帧率
  12. streamingQuality: 3,//1 LOW低清 352*288 2 MEDIUM标清 480*360 3 HIGH高清 640*480 4 SUPER高清 960*540 5 SUPER_HIGH 超高清 (1280*720)
  13. videoRenderMode: 2,//1 采集多大分辨率,则显示多大分辨率 2设置为16:9模式
  14. pushUrl:"rtmp://p56d785b4.live.126.net/live/05965c485ca640f693861f87ca71d68a?wsSecret=672fc37f4a66b60f4208cdbf12c05ec1&wsTime=1473839561",
  15. filterOn: true //是否开启滤镜
  16. },
  17. function(ret, err) {
  18. alert(JSON.stringify(ret) + " " + JSON.stringify(err));
  19. });

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true//布尔型;true||false
  3. }

err:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. msg: ""
  3. }

可用性

iOS、Android系统

可提供的1.0.0及更高版本

startLive

开始直播

startLive(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. }

示例代码

  1. var demo = api.require('vcloudLive');
  2. demo.startLive(function(ret, err) {
  3. alert(JSON.stringify(ret) + " " + JSON.stringify(err));
  4. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本

stopLive

停止直播

stopLive(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. msg: ""
  3. }

示例代码

  1. var demo = api.require('vcloudLive');
  2. demo.stopLive(function(ret, err) {});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

closeLive

关闭直播

closeLive(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. msg: ""
  3. }

示例代码

  1. var demo = api.require('vcloudLive');
  2. demo.closeLive(function(ret, err) {});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

startMusic

播放音乐

startMusic({params}, callback(ret, err))

params

path:

  • 类型:字符串
  • 描述:(必填项)mp3音乐路径文件,支持fs:// widget:// (备注:安卓不支持widget://);

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. msg: ""
  3. }

示例代码

  1. var demo = api.require('vcloudLive');
  2. demo. startMusic({
  3. path : "fs://shangxuege.mp3"
  4. },
  5. function(ret, err) {});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

stopMusic

停止音乐

stopMusic(callback(ret, err))

示例代码

  1. var obj = api.require('vcloudLive');
  2. obj.stopMusic(function(ret, err) {
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本

switchCamera

切换摄像头

switchCamera(callback(ret, err))

示例代码

  1. var obj = api.require('vcloudLive');
  2. obj.switchCamera(function(ret, err) {
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本

switchFlash

开关闪光灯

switchFlash(callback(ret, err))

示例代码

  1. var obj = api.require('vcloudLive');
  2. obj.switchFlash(function(ret, err) {
  3. alert(JSON.stringify(ret));
  4. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本

filterType

设置滤镜

filterType({params}, callback(ret, err))

params

filter:

  • 类型:字符串
  • 描述:(必填项)滤镜名称:(iOS:正常,黑白,自然,粉嫩,怀旧,美颜,android:正常,美颜);

示例代码

  1. var obj = api.require('vcloudLive');
  2. obj.filterType({
  3. filter:"黑白"
  4. },function(ret, err) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

iOS、Android系统

可提供的1.0.0及更高版本