# 默认界面扫码 默认界面扫码能力提供系统级体验一致的扫码界面，包含相机预览流，相册扫码入口，暗光环境闪光灯开启提示。Scan Kit默认界面扫码对系统相机权限进行了预授权且调用期间处于安全访问状态，无需开发者再次申请相机权限。适用于不同扫码场景的元服务开发。 ## 场景介绍 默认界面扫码能力提供了默认的扫码界面以及相册扫码入口，支持单码和多码识别，支持多种码类型，请参见[ScanType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scancore#scantype)。无需使用三方库就可快速帮助元服务处理各种扫码场景。 默认界面扫码UX： ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fc/v3/uWyw-_PJSzew4RDHs8JhoA/zh-cn_image_0000002733437478.png?HW-CC-KV=V1&HW-CC-Date=20260917T065301Z&HW-CC-Expire=31536000000&HW-CC-Sign=AFB1587D3286B7921B540A95D7CBADC7801BF49559AC14E6E45AC5D2AC85172D) > 说明 > > 1. 系统首次使用默认界面扫码功能时，会向用户弹出隐私横幅提醒。 > > 2. 用户可以点击"进一步了解"查看安全访问相机说明，也可以关闭隐私横幅，关闭后重新打开元服务的扫码界面将不再显示隐私横幅提醒，显示安全访问提示，3s后消失。 > > 3. 从API版本6.1.0(23)开始，默认界面扫码的标题支持根据[ScanOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api#scanoptions)的scanTypes进行动态显示。 > > * 在API版本6.1.0(23)之前，标题统一显示为"扫描二维码/条形码"。 > * 在API版本6.1.0(23)及之后： > * scanTypes为ALL、FORMAT_UNKNOWN，或同时包含条形码和二维码类型，标题显示为"扫描二维码/条形码"。 > * scanTypes未设置，标题显示为"扫描二维码/条形码"。 > * scanTypes仅包含条形码类型，标题显示为"扫描条形码"。 > * scanTypes仅包含二维码类型，标题显示为"扫描二维码"。 ## 约束与限制 * 从API版本26.0.0开始，支持使用[isDefaultScanSupported](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scancore#isdefaultscansupported)接口查询当前设备是否支持默认界面扫码。 * 从API版本6.1.0(23)开始，默认界面扫码的标题支持根据[ScanOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api#scanoptions)的scanTypes进行动态显示。 * 从API版本6.1.0(23)开始，默认界面扫码能力支持带后置相机的Wearable，可以通过[getSupportedCameras](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-camera-cameramanager#getsupportedcameras)接口查询是否带后置相机。 * 从API版本6.0.0(20)开始，默认界面扫码能力支持悬浮屏、分屏场景。 * 相册扫码只支持单码识别。 * 不支持界面UX添加自定义设置。 ## 业务流程 使用默认界面扫码的主要业务流程如下： ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9f/v3/7hvS4_rgSImTEFn_3X5-bg/zh-cn_image_0000002762997003.png?HW-CC-KV=V1&HW-CC-Date=20260917T065301Z&HW-CC-Expire=31536000000&HW-CC-Sign=C9752C7D5598504370EAEBE8233B6B1B43AF8C070C67436AAECB6BDE98826A3C) 1. 用户向元服务发起扫码请求。 2. 元服务通过调用Scan Kit的startScanForResult接口启动扫码界面。 3. 系统首次使用元服务的默认界面扫码功能时，会向用户弹出隐私横幅提醒。 4. 用户可以点击关闭隐私横幅，重新打开应用的扫码界面将不再显示隐私横幅提醒，显示安全访问提示，3s后消失。 5. Scan Kit通过Callback回调函数或Promise方式返回扫码结果。 6. 用户进行多码扫描时，需点击选择其中一个码图获取扫码结果返回。单码扫描则可直接返回扫码结果。 7. 元服务向用户返回扫码结果。 ## 接口说明 接口有两种返回形式：Callback和Promise。Callback和Promise只是返回值方式不一样，功能相同。startScanForResult接口打开的是元服务内呈现的扫码界面样式。具体API说明详见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api)。 |接口名|描述| |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------------------------------------------------| |[startScanForResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api#startscanforresult)(context: common.Context, options?: ScanOptions): Promise|启动默认界面扫码，通过ScanOptions进行扫码参数设置，返回扫码结果。使用Promise异步回调。| |[startScanForResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api#startscanforresult-2)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-common#context), options: [ScanOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api#scanoptions), callback: AsyncCallback<[ScanResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api#scanresult)>): void|启动默认界面扫码，通过ScanOptions进行扫码参数设置，返回扫码结果。使用callback异步回调。| |[startScanForResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api#startscanforresult-1)(context: common.Context, callback: AsyncCallback): void|启动默认界面扫码，返回扫码结果。使用callback异步回调。| > 说明 > > startScanForResult接口需要在页面和组件的生命周期内调用。若需要设置扫码页面为全屏或沉浸式，请参见[开发应用沉浸式效果](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-develop-apply-immersive-effects)。 ## 开发步骤 Scan Kit提供了调用默认界面进行扫码的能力，由扫码接口直接控制相机实现最优的相机放大控制、自适应的曝光调节、自适应对焦调节等操作，保障流畅的扫码体验，减少开发者的工作量。 以下示例为调用Scan Kit的startScanForResult接口跳转扫码页面。 1. 导入默认界面扫码模块，[scanCore](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scancore)提供扫码类型定义，[scanBarcode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/scan-scanbarcode-api)提供拉起默认界面扫码的方法和参数，导入方法如下。 ```typescript import { scanCore, scanBarcode } from '@kit.ScanKit'; // 导入默认界面扫码需要的日志模块和错误码模块 import { hilog } from '@kit.PerformanceAnalysisKit'; import { BusinessError } from '@kit.BasicServicesKit'; ``` 2. 调用startScanForResult方法拉起默认界面扫码。 * 通过Promise方式得到扫码结果。 ```typescript @Entry @Component struct ScanBarCodePage { build() { Column() { Row() { Button("Promise with options") .backgroundColor('#0D9FFB') .fontSize(20) .fontColor($r('sys.color.comp_background_list_card')) .fontWeight(FontWeight.Normal) .align(Alignment.Center) .type(ButtonType.Capsule) .width('90%') .height(40) .margin({ top: 5, bottom: 5 }) .onClick(() => { // 定义扫码参数options let options: scanBarcode.ScanOptions = { scanTypes: [scanCore.ScanType.ALL], enableMultiMode: true, enableAlbum: true }; scanBarcode.startScanForResult(this.getUIContext().getHostContext(), options) .then((data: scanBarcode.ScanResult) => { hilog.info(0x0001, '[Scan CPSample]', `Succeeded in getting scanResult by promise with options, scanType: ${data.scanType}`); }) .catch((err: BusinessError) => { hilog.error(0x0001, '[Scan CPSample]', `Failed to get scanResult by promise with options. Code: ${err.code}, message: ${err.message}`); }); }) } .height('100%') } .width('100%') } } ``` * 通过Callback回调函数得到扫码结果。 ```typescript @Entry @Component struct ScanBarCodePage { build() { Column() { Row() { Button('Callback with options') .backgroundColor('#0D9FFB') .fontSize(20) .fontColor($r('sys.color.comp_background_list_card')) .fontWeight(FontWeight.Normal) .align(Alignment.Center) .type(ButtonType.Capsule) .width('90%') .height(40) .margin({ top: 5, bottom: 5 }) .onClick(() => { // 定义扫码参数options let options: scanBarcode.ScanOptions = { scanTypes: [scanCore.ScanType.ALL], enableMultiMode: true, enableAlbum: true }; // 启动扫码，拉起扫码界面 scanBarcode.startScanForResult(this.getUIContext().getHostContext(), options, (err: BusinessError, data: scanBarcode.ScanResult) => { if (err) { hilog.error(0x0001, '[Scan CPSample]', `Failed to get scanResult by callback with options. Code: ${err.code}, message: ${err.message}`); return; } hilog.info(0x0001, '[Scan CPSample]', `Succeeded in getting scanResult by callback with options, scanType: ${data.scanType}`); }); }) } .height('100%') } .width('100%') } } ``` ## 模拟器开发 从API版本6.0.0(20)开始，模拟器支持默认界面扫码能力开发，模拟器使用指导请参见[使用模拟器运行应用](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-run-emulator)。 模拟器中默认界面扫码的相机流存在镜像问题，且由于仅支持固定分辨率比例，画面会出现上下黑边。