本模块提供默认界面扫码能力。
起始版本:4.0.0(10)
扫码结果。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.0.0(10)
名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
scanType | scanCore.ScanType | 否 | 否 | 码类型。 元服务API:从版本4.1.0(11)开始,该接口支持在元服务中使用。 |
originalValue | string | 否 | 否 | 码识别内容结果。 元服务API:从版本4.1.0(11)开始,该接口支持在元服务中使用。 |
scanCodeRect | 否 | 是 | 码识别位置信息。 起始版本:4.1.0(11) | |
cornerPoints | Array<Point> | 否 | 是 | 码识别角点位置信息,返回QR Code四个角点。 起始版本:5.0.0(12) 说明: 此参数仅图像识码接口detectBarcode.decodeImage返回。 |
码的位置信息。使用默认扫码接口(startScan和startScanForResult)不返回码位置。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.1.0(11)
名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
left | number | 否 | 否 | 码外接矩形左上角的x坐标。单位:px。 |
top | number | 否 | 否 | 码外接矩形左上角的y坐标。单位:px。 |
right | number | 否 | 否 | 码外接矩形右下角的x坐标。单位:px。 |
bottom | number | 否 | 否 | 码外接矩形右下角的y坐标。单位:px。 |
点坐标,该坐标系左上角为{0,0},此坐标系是以设备充电口在右侧时的横向设备方向为基准的。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:5.0.0(12)
名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
x | number | 否 | 否 | X轴坐标,单位:px。 |
y | number | 否 | 否 | Y轴坐标,单位:px。 |
扫码、识码参数。
元服务API:从版本4.1.0(11)开始,该接口支持在元服务中使用。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.0.0(10)
名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
scanTypes | Array<scanCore.ScanType> | 否 | 是 | 设置扫码类型,默认扫码ALL(全部码类型)。 |
enableMultiMode | boolean | 否 | 是 | 是否开启多码识别,默认false。
|
enableAlbum | boolean | 否 | 是 | 是否开启相册,默认true。
注意: 此参数只控制默认界面扫码能力中的相册识码且相册识码只支持单码识别。 |
示例:
import { scanBarcode, scanCore } from '@kit.ScanKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 定义扫码参数options
let options: scanBarcode.ScanOptions = { scanTypes: [scanCore.ScanType.ALL], enableMultiMode: true, enableAlbum: true };
try {
scanBarcode.startScanForResult(getContext(this), options).then((result: scanBarcode.ScanResult) => {
hilog.info(0x0001, '[Scan Sample]',
`Succeeded in getting ScanResult by promise with options, result is ${JSON.stringify(result)}`);
}).catch((error: BusinessError) => {
hilog.error(0x0001, '[Scan Sample]',
`Failed to get ScanResult by promise with options. Code: ${error.code}, message: ${error.message}`);
});
} catch (error) {
hilog.error(0x0001, '[Scan Sample]', `Failed to startScanForResult. Code: ${error.code}, message: ${error.message}`);
} startScanForResult(context: common.Context, options?: ScanOptions): Promise<ScanResult>
通过配置参数调用默认界面扫码,使用Promise异步回调返回解码结果。需要在页面和组件的生命周期内调用。
模型约束:此接口仅可在Stage模型下使用。
元服务API: 从版本4.1.0(11)开始,该接口支持在元服务中使用。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.1.0(11)
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
context | 是 | 应用上下文。 | |
options | 否 | 启动扫码参数。 |
类型 | 说明 |
|---|---|
Promise<ScanResult> | Promise对象,返回扫码结果对象。 |
错误码:
以下错误码的详细介绍请参见ArkTS API错误码。
错误码ID | 错误信息 |
|---|---|
401 | Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. |
1000500001 | Internal error. |
1000500002 | The user canceled the barcode scanning. |
import { scanCore, scanBarcode } from '@kit.ScanKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 定义扫码参数options
let options: scanBarcode.ScanOptions = { scanTypes: [scanCore.ScanType.ALL], enableMultiMode: true, enableAlbum: true };
try {
scanBarcode.startScanForResult(getContext(this), options).then((result: scanBarcode.ScanResult) => {
hilog.info(0x0001, '[Scan Sample]',
`Succeeded in getting ScanResult by promise with options, result is ${JSON.stringify(result)}`);
}).catch((error: BusinessError) => {
hilog.error(0x0001, '[Scan Sample]',
`Failed to get ScanResult by promise with options. Code: ${error.code}, message: ${error.message}`);
});
} catch (error) {
hilog.error(0x0001, '[Scan Sample]', `Failed to startScanForResult. Code: ${error.code}, message: ${error.message}`);
} startScanForResult(context: common.Context, callback: AsyncCallback<ScanResult>): void
启动默认界面扫码,使用Callback异步回调返回解码结果。需要在页面和组件的生命周期内调用。
模型约束:此接口仅可在Stage模型下使用。
元服务API: 从版本4.1.0(11)开始,该接口支持在元服务中使用。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.1.0(11)
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
context | 是 | 应用上下文。 | |
callback | AsyncCallback<ScanResult> | 是 | 回调函数。当扫码返回成功,err为undefined,data为获取到的扫码结果对象ScanResult;否则为错误对象。 |
错误码:
以下错误码的详细介绍请参见ArkTS API错误码。
错误码ID | 错误信息 |
|---|---|
401 | Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. |
1000500001 | Internal error. |
1000500002 | The user canceled the barcode scanning. |
import { scanBarcode } from '@kit.ScanKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 启动扫码,拉起扫码界面
try {
scanBarcode.startScanForResult(getContext(this), (error: BusinessError, result: scanBarcode.ScanResult) => {
if (error) {
hilog.error(0x0001, '[Scan Sample]',
`Failed to get ScanResult by callback. Code: ${error.code}, message: ${error.message}`);
return;
}
hilog.info(0x0001, '[Scan Sample]',
`Succeeded in getting ScanResult by callback, result is ${JSON.stringify(result)}`);
});
} catch (error) {
hilog.error(0x0001, '[Scan Sample]', `Failed to startScanForResult. Code: ${error.code}, message: ${error.message}`);
} startScanForResult(context: common.Context, options: ScanOptions, callback: AsyncCallback<ScanResult>): void
通过配置参数调用默认界面扫码,使用Callback异步回调返回解码结果。需要在页面和组件的生命周期内调用。
模型约束:此接口仅可在Stage模型下使用。
元服务API:从版本4.1.0(11)开始,该接口支持在元服务中使用。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.1.0(11)
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
context | 是 | 应用上下文。 | |
options | 是 | 启动扫码参数。 | |
callback | AsyncCallback<ScanResult> | 是 | 回调函数。当扫码返回成功,err为undefined,data为获取到的扫码结果对象ScanResult;否则为错误对象。 |
错误码
以下错误码的详细介绍请参见ArkTS API错误码。
错误码ID | 错误信息 |
|---|---|
401 | Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. |
1000500001 | Internal error. |
1000500002 | The user canceled the barcode scanning. |
import { scanCore, scanBarcode } from '@kit.ScanKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 定义扫码参数options
let options: scanBarcode.ScanOptions = { scanTypes: [scanCore.ScanType.ALL], enableMultiMode: true, enableAlbum: true };
// 启动扫码,拉起扫码界面
try {
scanBarcode.startScanForResult(getContext(this), options, (error: BusinessError, result: scanBarcode.ScanResult) => {
if (error) {
hilog.error(0x0001, '[Scan Sample]',
`Failed to get ScanResult by callback with options. Code: ${error.code}, message: ${error.message}`);
return;
}
hilog.info(0x0001, '[Scan Sample]',
`Succeeded in getting ScanResult by callback with options, result is ${JSON.stringify(result)}`);
});
} catch (error) {
hilog.error(0x0001, '[Scan Sample]', `Failed to startScanForResult. Code: ${error.code}, message: ${error.message}`);
} startScan(options?: ScanOptions): Promise<ScanResult>
通过配置参数调用默认界面扫码,使用Promise异步回调返回扫码结果。
废弃说明:从版本4.1.0(11)开始废弃,建议使用startScanForResult替代。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.0.0(10)
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
options | 否 | 启动扫码参数。 |
类型 | 说明 |
|---|---|
Promise<ScanResult> | Promise对象,返回扫码结果对象。 |
错误码:
以下错误码的详细介绍请参见ArkTS API错误码。
错误码ID | 错误信息 |
|---|---|
401 | Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. |
import { scanCore, scanBarcode } from '@kit.ScanKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 构造启动扫码的入参options
let options: scanBarcode.ScanOptions = { scanTypes: [scanCore.ScanType.ALL], enableMultiMode: true, enableAlbum: true };
try {
scanBarcode.startScan(options).then((result: scanBarcode.ScanResult) => {
hilog.info(0x0001, '[Scan Sample]',
`Succeeded in getting ScanResult by promise with options, result is ${JSON.stringify(result)}`);
}).catch((error: BusinessError) => {
// 当扫码过程中出现错误打印报错并返回
hilog.error(0x0001, '[Scan Sample]',
`Failed to get ScanResult by promise with options. Code: ${error.code}, message: ${error.message}`);
});
} catch (error) {
hilog.error(0x0001, '[Scan Sample]', `Failed to startScan. Code: ${error.code}, message: ${error.message}`);
} startScan(callback: AsyncCallback<ScanResult>): void
启动默认界面扫码,使用Callback异步回调返回扫码结果。
废弃说明:从版本4.1.0(11)开始废弃,建议使用startScanForResult替代。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.0.0(10)
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
callback | AsyncCallback<ScanResult> | 是 | 回调函数。当扫码返回成功,err为undefined,data为获取到的扫码结果对象ScanResult;否则为错误对象。 |
错误码:
以下错误码的详细介绍请参见ArkTS API错误码。
错误码ID | 错误信息 |
|---|---|
401 | Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. |
import { scanBarcode } from '@kit.ScanKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
try {
scanBarcode.startScan((error: BusinessError, result: scanBarcode.ScanResult) => {
// error回调监听,当扫码过程中出现错误打印报错并返回
if (error) {
hilog.error(0x0001, '[Scan Sample]',
`Failed to get ScanResult by callback. Code: ${error.code}, message: ${error.message}`);
return;
}
hilog.info(0x0001, '[Scan Sample]',
`Succeeded in getting ScanResult by callback, result is ${JSON.stringify(result)}`);
});
} catch (error) {
hilog.error(0x0001, '[Scan Sample]', `Failed to startScan. Code: ${error.code}, message: ${error.message}`);
} startScan(options: ScanOptions, callback: AsyncCallback<ScanResult>): void
通过配置参数调用默认界面扫码,使用Callback异步回调返回扫码结果。
废弃说明:从版本4.1.0(11)开始废弃,建议使用startScanForResult替代。
系统能力:SystemCapability.Multimedia.Scan.ScanBarcode
起始版本:4.0.0(10)
参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
options | 是 | 启动扫码参数。 | |
callback | AsyncCallback<ScanResult> | 是 | 回调函数,当扫码返回成功,err为undefined,data为获取到的扫码结果对象ScanResult;否则为错误对象。 |
错误码:
以下错误码的详细介绍请参见ArkTS API错误码。
错误码ID | 错误信息 |
|---|---|
401 | Parameter error. Possible causes: 1. Incorrect parameter types; 2. Parameter verification failed. |
import { scanCore, scanBarcode } from '@kit.ScanKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
// 构造启动扫码的入参options
let options: scanBarcode.ScanOptions = { scanTypes: [scanCore.ScanType.ALL], enableMultiMode: true, enableAlbum: true };
try {
scanBarcode.startScan(options, (error: BusinessError, result: scanBarcode.ScanResult) => {
// error回调监听,当扫码过程中出现错误打印报错并返回
if (error) {
hilog.error(0x0001, '[Scan Sample]',
`Failed to get ScanResult by callback with options. Code: ${error.code}, message: ${error.message}`);
return;
}
hilog.info(0x0001, '[Scan Sample]',
`Succeeded in getting ScanResult by callback with options, result is ${JSON.stringify(result)}`);
});
} catch (error) {
hilog.error(0x0001, '[Scan Sample]', `Failed to startScan. Code: ${error.code}, message: ${error.message}`);
}