更新记录

1.0.1(2024-07-11)

修改调用 init 提示不存在的 bug (*init 之后设置使用的相机 id 请参考文档) 修改第一次拍照之后再次调用抓拍会失败的 bug

1.0.0(2024-06-24)

首个版本,暂时不支持自定义图片质量,暂不支持保存到本地,后续会持续更新完善


平台兼容性

Android Android CPU类型 iOS
适用版本区间:6.0 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


获取权限

使用之前请确保已经提前获取过相机访问权限。 如何获取相机权限请参照uni官方文档。 考虑到功能以静默拍照,抓拍为主,如果调用相机时突然冒出授权访问相机的提示会比较怪,所以插件中没有主动获取相机权限的代码,请自己提前获取。

初始化

//第一步加载插件
let cc = uni.requireNativePlugin("Tilecats-Unicc");
//调用初始化函数
cc.init();
//获取摄像头 id 的列表
cc.getCameraIdList(
  (cameras)=>{
    cc.setUseCameraId(cameras[0]);
  }
);

如果只是调用 init,并未使用 setUseCameraId 设置相机,默认使用获取到的第一个相机 id

抓拍

cc.takeSnapImage(
    {}, //预留参数,先传空object,第一个版本不支持设置图像质量等,后续会更新
    (image)=>{
        //image中保存的是 base64 数据,这里替换掉里面回车换行后,添加头部信息,即可在 ui 中展示
        //后续版本会增加保存照片到本地后返回图片路径的功能,第一版图方便,以 base64 返回
        let imageBase64 = "data:image/png;base64," + image.replace(/[\r\n]/g, "");
    }
);

//示例UI展示代码
<image style="width: 150px;height: 100px;" mode="aspectFill" :src="imageBase64"></image>

注意

由于拍照涉及到获取相机-拍照-处理图片,整个流程耗时较久(1-2秒),所以如果快速连续拍照可能会失败,建议在拍照后等待2-3秒时间再进行下一次拍照。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.CAMERA"/>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问