更新记录
3.0.0(2024-03-23)
- Android 端新增两个不同的拍摄风格,新增type, resolution,minTip,setMinduration,videoQuality,timeType 等参数。
2.9.0(2024-03-13)
- 新增参数 saveDirectory 来设置自定义储存文件的路径文件夹。
- 新增参数 saveToAlbum 来设置视频是否保存到相册,方便测试查看视频。
2.8.0(2024-03-08)
- 新增视频比例预览 ratio 参数:1/1 , 3/4 , 9/16 设置。
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 14.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 | 适用版本区间:9 - 17 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
Android 和 IOS 拍照录影一体化插件
1.实例化插件
const plug=uni.requireNativePlugin("Html5App-CameraView");
2.调用插件打开拍照录影,本插件只有一个方法:open
plug.open(
{
setMaxduration:15,
SpeedColor:"#3eafff",
camera:"first"
},retult=>
{
});
3. open 方法包含2个参数:一个是 JSON 配置参数,一个是 retult 回调方法。
JSON 包含4个配置参数:
参数名称 | 说明 | 默认值 | 类型 |
---|---|---|---|
type | 拍摄界面风格设置:0,1,2 | 0 | int |
setMaxduration | 设置最大的可录制时间(单位/秒) | 10 | int |
setMinduration | 设置最小录制时间(单位/秒) | 1 | int |
setFeatures | 设置拍摄模式:1=>拍照模式,2=>拍摄模式,长按或点击按键都可以开始录制,3=> 两者都可以 | 3 | int |
videoQuality | 设置视频质量比特率 低清:500~1000,标清:1000~3000,高清:3000~6000,超清:6000~12000, 设置的值越大代表视频文件也会大,根据视频需求适当填写 |
5000 | kbps |
resolution | 设置拍摄的分辨率:720p,1080p ,支持可拍摄的分辨率,如果摄像头不支持,则自动选择 | 720p | string |
minTip | 设置录制最小时长不够时提示 | 录制时间过短 | string |
setTip | 设置提示文字 | 轻按拍照,长按录影 | string |
SpeedColor | 录影时进度条的颜色设置 | 绿色, 颜色格式:#3eafff | string |
camera | 设置打开时默认前置或后置摄像头, 后置摄像头:back,前置摄像头:first | back | string |
isTimeShow | 是否显示倒计时 | false | boolean |
timeColor | 时间字体颜色 | #ffffff | string |
timeType | 时间显示类型:倒计时:down,顺计时:up | down | string |
prompt | 内容提示语 | 空 | string |
promptColor | 提示语文字颜色 | #ffffff | string |
promptTextSize | 提示语字体大小设置 | 16 | float |
quality | 图片压缩质量值:0-100 范围 | 50 | int |
setFlash | 设置闪光灯开启/关闭,默认打开时是关闭 | false | bool |
ratio | 拍摄比例设置:9/16,3/4,1/1 ,不是所有摄像头都支持:1:1,建议设置9/16或3:4 即可 | 9/16 | string |
saveDirectory | 设置自定义的储存文件夹路径 例如:plus.io.convertLocalFileSystemURL("_doc") | string | |
saveToAlbum | 设置是否把视频保存到相册,方便查看视频,默认否 | false | bool |
retult 回调方法返回一个JOSN 格式数据
参数名称 | 参数说明 |
---|---|
result | 返回结果 成功 "success" / 取消 "cancel" |
message | 提示内容 |
image | 图片路径:包括录影时返回视频第一帧视频截图 ,APP绝对路径 |
mp4 | 视频路径, APP绝对路径 |
type | 视频"video"" / 拍照 "image" |
size | 文件的大小,如果是视频拍摄则是视频的大小,拍照则是图片的大小,单位MB |
duration | 视频时长, 单位秒. |
4. Android 6.0 以下,无法动态获得权限,如果没有权限被禁止则会回调
参数名称 | 参数说明 |
---|---|
result | 返回结果 "permission" |
message | 请到设置-应用权限管理中开启应用:拍照录影/录音权限,才可正常使用 |