acLive

来自于:AC模块工作室立即使用

概述

本模块封装了通过摄像头视频采集及推流的相关功能,开发者可自行 open 一个 frame 贴在模块上,从而实现自定义采集界面的功能,通过调用start、end、switchCamera、beautyFace接口实现开始结束推流,摄像头切换,美颜等功能

模块接口

open

打开摄像头采集页面

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

params

camera:

  • 类型:数字类型
  • 描述:(可选)设备摄像头选择
  • 内部字段:1/前置摄像头,0/后置摄像头
  • 默认:1

rect:

  • 类型:JSON 对象
  • 描述:采集画面的位置及尺寸
  • 内部字段:
{
    x: 0,   // 数字类型;模块左上角的 x 坐标(相对于所属的 Window 或 Frame);默认值:0
    y: 0,   // 数字类型;模块左上角的 y 坐标(相对于所属的 Window 或 Frame);默认值:0
    w: 320, // 数字类型;模块的宽度;支持设置'auto';默认值:所属的 Window 或 Frame 的宽度
    h: 250  // 数字类型;模块的高度;支持设置'auto';默认值:所属的 Window 或 Frame 的高度
}

fixedOn:

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

fixed:

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

callback(ret,err)

ret:

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

err:

  • 类型:JSON 对象
  • 内部字段:
{
    msg : ''
}

示例代码

var acLive = api.require('acLive');
acLive.open({
    rect : {
        x : 0,
        y : 150,
        h : 400
    }
},function(ret, err){
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

close

关闭录像采集页面

close()

示例代码

var acLive = api.require('acLive');
acLive.close();

可用性

iOS、Android系统

可提供的1.0.0及更高版本

start

开始推流

start({params}, callback(ret))

params

url:

  • 类型:字符
  • 描述:推流地址

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:'',      //字符类型;连接状态
                    //取值如下:
                    //0:准备连接(仅ios支持)
                    //1:连接中(仅ios支持)
                    //2:已连接
                    //3:已断开
                    //4:连接出错
                    //5:正在刷新(仅ios支持)
}

示例代码

var acLive = api.require('acLive');
acLive.start({
    url:'' 
},function(ret, err){
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

end

结束推流

end()

示例代码

var acLive = api.require('acLive');
acLive.end();

可用性

iOS、Android系统

可提供的1.0.0及更高版本

switchCamera

切换摄像头

switchCamera()

示例代码

var acLive = api.require('acLive');
acLive.switchCamera();

可用性

iOS、Android系统

可提供的1.0.0及更高版本

beautyFace

开启关闭美颜

beautyFace()

示例代码

var acLive = api.require('acLive');
acLive.beautyFace();

可用性

iOS、Android系统

可提供的1.0.0及更高版本