一、码生成
码生成能够根据开发者给定的字符串信息和二维码图片尺寸,返回相应的二维码图片字节流。
调用方可以通过二维码字节流生成二维码图片。
二、约束与限制
当前仅支持生成 QR 二维码(Quick Response Code)。
由于 QR 二维码算法的限制,字符串信息的长度不能超过2953个字符。生成的二维码图片的宽度不能超过 1920 像素,高度不能超过 1680 像素。
由于 QR 二维码是通过正方形阵列承载信息的,建议二维码图片采用正方形,当二维码图片采用长方形时,会在 QR 二维码信息的周边区域留白。
三、应用场景
码生成能够根据给定的字符串信息,生成相应的二维码图片。常见应用场景举例:
社交或通讯类应用:根据输入的联系人信息,生成联系人二维码。
购物或支付类应用:根据输入的支付链接,生成收款或付款二维码。
四、接口说明
码生成提供了的 IBarcodeDetector() 接口,常用方法的功能描述如下:
接口名
方法
功能描述
IBarcodeDetector
int detect(String barcodeInput, byte[] bitmapOutput, int width, int height);
根据给定的信息和二维码图片尺寸,生成二维码图片字节流
IBarcodeDetector
int release();
停止QR码生成服务,释放资源
五、开发步骤
在使用码生成 SDK 时,需要先将相关的类添加至工程:
import ohos.ai.cv.common.ConnectionCallback;
import ohos.ai.cv.common.VisionManager;
import ohos.ai.cv.qrcode.IBarcodeDetector;
定义 ConnectionCallback 回调,实现连接能力引擎成功与否后的操作:
ConnectionCallback connectionCallback = new ConnectionCallback() {
@Override
public void onServiceConnect() {
// Do something when service connects successfully
}
@Override
public void onServiceDisconnect() {
// Do something when service connects unsuccessfully
}
};
调用 VisionManager.init() 方法,将此工程的 context 和 connectionCallback 作为入参,建立与能力引擎的连接,context 应为 ohos.aafwk.ability.Ability 或 ohos.aafwk.ability.AbilitySlice 的实例或子类实例:
int result = VisionManager.init(context, connectionCallback);
实例化 IBarcodeDetector 接口,将此工程的 context 作为入参:
IBarcodeDetector barcodeDetector = VisionManager.getBarcodeDetector(context);
定义码生成图像的尺寸,并根据图像大小分配字节流数组空间:
final int SAMPLE_LENGTH = 152;
byte[] byteArray = new byte[SAMPLE_LENGTH * SAMPLE_LENGTH * 4];
调用 IBarcodeDetector的detect() 方法,根据输入的字符串信息生成相应的二维码图片字节流,如果返回值为0,表明调用成功:
int result = barcodeDetector.detect("This is a TestCase of IBarcodeDetector", byteArray, SAMPLE_LENGTH, SAMPLE_LENGTH);
当码生成能力使用完毕后,调用 IBarcodeDetector 的 release() 方法,释放资源:
result = barcodeDetector.release();
调用 VisionManager.destroy() 方法,断开与能力引擎的连接:
VisionManager.destroy();