更新记录

0.0.2（2021-06-23）

heic、heif、webp、heif、avif 转换 jpeg 格式

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

来自于：DWZ Mobile

概述

点击查看官方文档

• 本插件是会对字节跳动火山引擎图片加载 SDK 的封装：

  • 支持现代图片格式 heic、heif、webp、heif、avif 在 HTML5 混合 App 中展示
  • 支持用户感知失败率、解码失败率、解码耗时、超分成功率、超分耗时、排队耗时、加载耗时、文件大小等指标打点上报

• 本插件适用的业务场景：uniapp 开发安卓和 iOS 应用时，如果有大量的图片加载和展示，比如电商产品图片展示、电子相册等场景

• 为什么要使用 dwz-BytedanceImageX

  • 先看一个测评：高效的图像处理云服务-ImageX
  • 新款的 iPhone 和一部分新出的安卓手机拍照生成的图片采用新的图片格式 heic，清楚度和分辨率相同的一张 heic 图片，比 jpeg 格式小 7~8 倍，比 png 格式小 20 倍以上，所以如果服务器和 app 之间图片传输如果使用 heic 格式可以至少减少 7 倍流量，可以大大提高图片加载速度
  • 由于 HTML5 img 标签是不能识别 heic 图片，需要使用火山引擎图片加载 SDK 对 heic 图片解码转化成 jpeg 格式

• 本插件针对一个 APP 一次购买永久使用

• 跨平台支持（Android & iOS）iOS 端与 Android 端 JS 接口保持一致

• 插件使用含技术支持，远程协助调试插件请加 QQ 350863780

安卓 APK 测试包	技术服务微信

为帮助用户更好更快的使用插件，点击查看 dwz-BytedanceImageX 插件详细对接文档，包含示例代码、知识点讲解、注意事项等，供您参考。

对接步骤

1. 使用之前须从火山引擎开放平台申请开发者账号并完成企业认证，获取 aid。字节跳动火山引擎开发平台控制台
2. 对接火山引擎服务器端图片上传 SDK
3. 服务端和 App 数据交互接口，图片 url 使用火山引擎的图片 url
4. App 获取火山引擎 heic 图片 url
5. 前端代码调用 dwz-BytedanceImageX 插件，把 heic 等格式转化成 jpeg 格式

图片转化接口 convertImg

heic、heif、webp、heif、avif 格式转化为 jpeg 格式的 base64 字符串，返回给前端 js

const module = uni.requireNativePlugin('dwz-BytedanceImageX');
module.convertImg(
    {
        debug: 0, // 调试开关(默认:0)：0, 1
        url: item.url, // 原图url
        quality: 100 // 抠图压缩质量，取值范围 20 ~ 100，默认100不压缩
    },
    (ret) => {
        console.log(ret);
    }
);

回调 callback(ret)

ret：

• 类型：JSON 对象
• 内部字段：

{
    "status": 1, //状态值（整数）；1||0，人脸识别成功/失败
    "base64str": "data:image/jpeg;base64,xxx" // jpeg格式base64图片
}

可用性

iOS 系统(正在开发中)，Android 系统