/**
 * 相机模块提供了移动设备相机接口的调用,开发者可使用该模块进行相机操作的调用,应用场景包括:
 * <ul>
 *     <li>拍照/录像</li>
 *     <li>调用相册</li>
 *     <li>二维码扫描</li>
 * </ul>
 * @module Camera
 */

/**
 * 照相机
 * <br>包含了拍照获取图片/视频功能、调用相册获取图片功能
 * <br>根据开发者不同需求,可返回的图像数据有1、base64格式字符串;2、图像文件路径;3、本地图像路径
 * @namespace cmp
 * @class camera
 */


/**
 * 获取图像方法,开发者可通过配置获取自己想要的图像文件数据
 * @method getPictures
 * @namespace cmp.camera
 * @param {Object} [options] 获取图像配置参数对象
 *      @param {Boolean} [options.compress] 是否返回压缩后的图片,true:返回缩略图,false:返回原图
 *      @param {Number} [options.quality] 摄像头品质参数(范围0~100,默认100)
 *      @param {Number} [options.targetWidth] 生成的图像宽度
 *      @param {Number} [options.targetHeight] 生成的图像高度
 *      @param {Boolean} [options.saveToPhotoAlbum] 是否将图像保存到相册
 *      @param {Number} [options.destinationType] 返回的图像数据类型:<br>
 *                                                           <ul>
 *                                                               <li>0:base64格式(默认)</li>
 *                                                               <li>1:图像文件路径</li>
 *                                                               <li>2:本地图片路径</li>
 *                                                           </ul>
 *                                                           <br><span style="color:red;">注:M1平台返回图片路径+base64,纯H5平台只返回base64</span>
 *     @param {Number} [options.sourceType] 获取图像文件的方式:<br>
 *                                                      <ul>
 *                                                          <li>0:图片库</li>
 *                                                          <li>1:摄像头(默认)</li>
 *                                                          <li>2:相册</li>
 *                                                      </ul>
 *    @param {Number} [options.encodingType] 图像编码类型:<br>
 *                                                  <ul>
 *                                                      <li>0:jpeg(默认)</li>
 *                                                      <li>1:png</li>
 *                                                  </ul>
 *    @param {Number} [options.pictureNum] 选择图片的数量:默认数量:9;<br ><span style="color:red;">注:在M1平台下不支持多选</span>
 *
 *    @param {Function} [options.success] 执行成功后的回调函数
 *    @param {Function} [options.error] 执行失败后的回调函数
 *    @returns {Object} result 返回值:<br>
 *        <ul>
 *            <li>result.success:成功与否标识,true:成功;false:失败</li>
 *            <li>result.files:返回的图片数据(数组)
 *                  <ul>
 *                      <li>base64:图片的base64字符串(压缩后的,一般作为缩略图展示)</li>
 *                      <li>filepath:图片的原图路径<span style="color:red;">注:纯H5平台下该值不返回</span></li>
 *                      <li>fileSize:图片的原图大小(单位:byte)</li>
 *                      <li>type:图片的类型</li>
 *                  </ul>
 *            </li>
 *        </ul>
 * @example
 * ```
 * <script>
 *     cmp.camera.getPictures({
     *          compress:true,
     *          quality:100,
     *          targetWidth:-1,
     *          targetHeight:-1,
     *          saveToPhotoAlbum:true,
     *          destinationType:0,
     *          sourceType:1,
     *          encodingType:0,
     *          success:function(cameraResult){
     *                  cameraResult = {
     *                   success:true,
     *                   files:[{  /真实的图片数组
     *                       base64:'data:image/jpg;base64,iVBORw',//图片的base64字符串
     *                       filepath:"/storage/emulated/0/Tencent/QQfile_recv/QQDataLineGuidePic.png", //真实图片的地址
     *                       fileSize:"1024",  //图片大小
     *                       type:"png",
     *                       index:1~9//选择图片的顺序,ios  iphone6无法确定选择的顺序
     *                   }]
     *               };
     *              },
     *          error:function(){
     *                  //do something
     *              }
     *     });
 * </script>
 * ```
 */


/**
 * 扫描二维码<br>
 *     可实现扫描二维码和制作二维码的功能
 * @class scan
 * @namespace cmp
 * @constructor
 * @param options {object} 配置参数对象
 * @param {Function} [options.success] 成功回调函数
 * @param {Function} [options.error] 失败回调函数
 * @example
 * ```
 * <script>
 *      cmp.scan({
     *          success:function(){
     *          //do something...
     *          },
     *          error:function(){
     *          //do something...
     *          }
     *      });
 * </script>
 * ```
 */

/**
 * 制作二维码
 * @class makeBarScan
 * @namespace cmp
 * @constructor
 * @param options {object} 配置项参数
 * @param {String} options.data 被用于制作二维码的字符串数据
 * @param {Function} [options.success] 成功回调函数
 * @param {Function} [options.error] 失败回调函数
 * @example
 * ```
 * <script>
 *     cmp.makeBarScan({
     *          data:"",
     *          success:function(){
     *                  //do something
     *              },
     *          error:function(){
     *                  //do something
     *              }
     *     });
 * </script>
 * ```
 */
    
Top