camera


简介:

Camera模块管理设备的摄像头,可用于拍照、摄像操作,通过rd.camera获取摄像头管理对象。

方法:

回调方法:

captureImage


进行拍照操作

rd.camera.captureImage(ImageSuccessCallback, ImageErrorCallback, option);
说明:

拍照操作成功将通过ImageSuccessCallback()方法返回拍照获取的图片路径,拍照操作取消将通过ImageErrorCallback()方法返回操作信息。可通过option设置摄像头的各种属性参数。

参数:
  • ImageSuccessCallback(): 必选 拍照操作成功的回调函数。

  • ImageErrorCallback(): 必选 拍照操作取消的回调函数。

  • option:(JSON) 必选 摄像头拍照参数。

    • resolution:(摄像分辨率) 拍照或摄像的文件分辨率。该属性支持iOS平台,不支持Android平台。
    • filename: ( String ) 拍照或摄像文件保存的路径。对摄像操作而言,在iOS平台中,不需要此属性,由程序自动生成保存路径。Android云编译时由于安卓系统原因只支持协议路径 'cache://' 。
    • index: ( Number ) 拍照或摄像默认使用的摄像头。拍照或摄像界面使用的摄像头编号,0表示后摄像头,1表示前摄像头。该属性支持iOS平台,不支持Android平台。
    • 摄像分辨率(Number):
      • rd.camera.ResolutionTypeHigh:值为0,高质量
      • rd.camera.ResolutionTypeMedium,:值为1,中等质量
      • rd.camera.ResolutionTypeLow:值为2,低质量
      • rd.camera.ResolutionTypeIFrame640x480:值为3,VGA质量
      • rd.camera.ResolutionTypeIFrame1280x720,:值为4,1280*720
      • rd.camera.ResolutionTypeIFrame960x540:值为5,960*540
返回值:

示例:
function captureImage()
{   
    var a = rd.camera.ResolutionTypeMedium;//设置摄像分辨率

    var option = {resolution:a,index:0,filename:'data://hi.jpg'};

    rd.camera.captureImage(ImageSuccessCallback,ImageErrorCallback,option);
}
function ImageSuccessCallback( capturedFile ){
    //拍照成功回调
}
function ImageErrorCallback(error){
    //拍照失败回调
}    

ImageSuccessCallback


调用摄像头操作成功回调

function  ImageSuccessCallback ( capturedFile ) {
// Caputre image/video file code.
}
说明:

调用摄像头操作成功的回调函数,在拍照或摄像操作成功时调用,用于返回图片或视频文件的路径。

参数:
  • capturedFile: ( String ) 必选 拍照或摄像操作保存的文件路径
返回值:

ImageErrorCallback


拍照失败回调

function ImageErrorCallback (error) {
// Handle camera error
}
参数:
  • error: ( String ) 必选 拍照失败回调
返回值:

captureVideo


用摄像头进行摄像操作

rd.camera.captureVideo(VideoSuccessCallback, VideoErrorCallback, option);
说明:

摄像操作成功将通过successCB返回摄像获取的视频文件路径,拍照操作取消将通过errorCB返回操作信息。可通过option设置摄像头的各种属性参数。

参数:
  • VideoSuccessCallback():必选 摄像操作成功的回调函数。

  • VideoErrorCallback():必选 摄像操作取消的回调函数。

  • option:(JSON)必选 摄像头拍照参数。

    • resolution:(摄像分辨率) 拍照或摄像的文件分辨率。该属性支持iOS平台,不支持Android平台。
    • filename: ( String ) 拍照或摄像文件保存的路径。对摄像操作而言,在iOS平台中,不需要此属性,由程序自动生成保存路径。Android云编译时由于安卓系统原因只支持协议路径 'cache://' 。
    • index: ( Number ) 拍照或摄像默认使用的摄像头。拍照或摄像界面使用的摄像头编号,0表示后摄像头,1表示前摄像头。该属性支持iOS平台,不支持Android平台。

摄像分辨率(Number)

  • rd.camera.ResolutionTypeHigh:值为0,高质量

  • rd.camera.ResolutionTypeMedium,:值为1,中等质量

  • rd.camera.ResolutionTypeLow:值为2,低质量

  • rd.camera.ResolutionTypeIFrame640x480:值为3,VGA质量

  • rd.camera.ResolutionTypeIFrame1280x720,:值为4,1280*720

  • rd.camera.ResolutionTypeIFrame960x540:值为5,960*540

返回值:

示例:
 function captureVideo()
 {               
    var a = rd.camera.ResolutionTypeMedium;//设置摄像头分辨率

    var option = {resolution:a,index:0,filename:'data://hi.mp4'};

    rd.camera.captureVideo(VideoSuccessCallback,VideoErrorCallback,option);
 }
 function VideoSuccessCallback(capturedFile ){
    //摄像成功回调
 }    
 function VideoErrorCallback(error){
     //摄像失败回调
 }

VideoSuccessCallback


调用摄像头操作成功回调

function  VideoSuccessCallback (capturedFile) {
// Caputre image/video file code.
}
说明:

调用摄像头操作成功的回调函数,在拍照或摄像操作成功时调用,用于返回图片或视频文件的路径。

参数:
  • capturedFile: ( String ) 必选 拍照或摄像操作保存的文件路径
返回值:

VideoErrorCallback


摄像头操作取消回调

function VideoErrorCallback(error) {
// Handle camera error
}
参数:
  • error: ( String ) 必选 摄像头操作取消信息
返回值: