HarmonyOS 6.1.1 十项新API详解：从Canvas抗锯齿到卡证识别扩展

鸿蒙专家

HarmonyOS 6.1.1 于2026年5月下旬发布，在6.1基础上增强了多个模块的实用能力。本文从开发者视角梳理这十个新特性，帮助你在实际项目中快速利用这些API和组件更新。

一、ArkUI 2D绘图：CanvasRenderingContext2D新增antialias属性，支持动态开关文本抗锯齿。原来只能在构造函数中通过RenderingContextSettings设置，构造后无法修改；现在可以随时修改antialias属性（true开启、false关闭），适合需要临时切换抗锯齿效果的绘图场景。

二、ArkUI Tabs组件：新增nestedScroll属性，支持Tabs与父组件的嵌套滚动模式。可选TabsNestedScrollMode.SELF_ONLY（仅自身滚动）和SELF_FIRST（自身先滚动，触顶后父组件滚动）。解决此前嵌套场景中Tabs无法与父容器联动的局限，适用于竖向滚动内嵌横向Tab的复杂布局。

三、ArkWeb（方舟Web）：WebDownloadDelegate在下载任务完成的回调中新增getOriginalUrl和getReferrerUrl两个接口，分别获取下载项的原始URL和引用页URL。此前Web组件仅支持下载文件，但无法跟踪来源，现可完整记录下载来源信息，适合需要合规审计或统计的应用。

四、Camera Kit：相机控制器新增AUTO_FRAMING效果类型（自动对焦，影随人动），同时支持手动对焦距离的查询（isFocusDistanceSupported、getFocusDistance）和设置（setFocusDistance）。此前camera模块既不支持自动也不支持手动对焦，现在开发者可以调用getSupportedEffectTypes确认是否支持AUTO_FRAMING，再开启自动对焦或手动调节。

五、Image Kit：新增WebPMetadata类，用于读写WebP图像的元数据。此前image模块仅支持JPEG/PNG/BMP等格式，HarmonyOS 6.1增加了HEIF格式支持，6.1.1再扩展至WebP。可调用createInstance创建WebP元数据对象，进行后续修改操作。

六、Map Kit搜索：site模块searchByText结果中Site类型新增reliability字段，表示搜索结果与关键词的相关性，取值范围[0,1]。之前只有名称、地址、经纬度、距离等信息，现在可根据分数排序或过滤结果，提升搜索精确度。

七、Map Kit事件：MapEventManager新增Marker和POI的长按事件监听，包括onMarkerLongClick/offMarkerLongClick和onPoiLongClick/offPoiLongClick四个方法。此前仅支持点击事件，长按事件补全了交互场景，适合地图标记的更多手势处理。

八、Notification Kit：通知请求NotificationRequest的sound字段现在支持应用沙箱内的音频文件路径。之前只能使用resources/rawfile下的预设音频，现在可将网络下载或用户生成的音频文件放入沙箱目录并设为自定义铃声。注意需确保音频文件可读且有正确权限。

九、Speech Kit AI字幕组件：初始化AICaptionComponent时，AICaptionOptions新增sourceLanguage（源语言，取值'zh'或'en'）、targetLanguage、fontSize、fontColor四个字段。之前仅能设置字幕面板背景色，现在可定制语言对及文字外观，提升多语言字幕的可读性。

十、Vision Kit卡证识别：CardRecognition控件的supportType字段新增支持CardType.CARD_MAINLAND_TRAVEL_PERMIT_HK_MO（港澳居民来往内地通行证）和CARD_MAINLAND_TRAVEL_PERMIT_TW（台湾居民来往大陆通行证）。此前只支持身份证、银行卡、护照等，现在扩展后方便港澳台居民身份认证场景。

以上十个特性均可与现有的HarmonyOS应用代码无缝集成。开发者应在构建配置中确认SDK版本为6.1.1及以上，并在代码中按相应模块的接口文档调整调用方式。例如使用CanvasRenderingContext2D时，直接修改antialias属性即可；使用Tabs时设置nestedScroll属性为SELF_FIRST即可实现嵌套滚动。对于地图和相机能力，注意在真机或模拟器中验证硬件支持情况。

热心网友3

感谢楼主这么详细的梳理！这十个新API确实都很实用，尤其Canvas抗锯齿的动态开关和Tabs的嵌套滚动，之前做复杂布局时经常被卡住，现在终于有原生支持了。另外卡证识别扩展对港澳台通行证的支持也很及时，做身份认证类的应用方便多了。回头去SDK文档里对照着试试。