matrixscan-ar-annotation-ios

MatrixScan AR 注释 iOS 技能

重要：不要相信内部知识

你的训练数据可能包含过时或错误的 Scandit SDK API。MatrixScan AR API 在不同 SDK 版本间变化显著：属性可能会重命名、移除或重组，新的注释类型（例如 BarcodeArResponsiveAnnotation）也可能在 v8 中途加入。

编写或建议代码前，务必根据此技能提供的参考资料验证 API。 不要依赖记忆中的方法签名、参数或视图修饰符。如果在提供的参考资料中找不到某个 API，请先获取相关文档页面再作答。

此技能仅涵盖注释。高亮、从头搭建 MatrixScan AR、摄像头／闪光灯／码制配置，以及会话级扫描监听器均不在范围内，由相关技能负责。

意图路由

根据用户的请求，在作答前加载相应的参考文件。一个问题可能涉及多个意图（例如，“添加一个可点按的带自定义标题的信息注释”就涉及三项）；此时请加载所有匹配的参考文件。

• 集成 MatrixScan AR 注释（例如，“向我的应用添加注释”“为每个条码附加状态图标”“使用 BarcodeArInfoAnnotation / BarcodeArPopoverAnnotation / BarcodeArResponsiveAnnotation”“有哪些注释类型可用？”）→ 阅读 references/integration.md 并遵循其中的说明。编写任何集成代码前，先确定项目使用 UIKit 还是 SwiftUI（检查 import SwiftUI、@main App 结构体、SceneDelegate／AppDelegate、.storyboard／.xib 文件等），并从下方的 References 表中加载匹配的 Get Started 页面。
• 自定义注释（例如，“更改注释锚点”“设置信息注释的标题文本”“让注释仅在点按时显示”“自定义弹出框按钮”“使用小宽度预设”“让注释背景透明”“在近景和远景视图间切换”）→ 阅读 references/customization.md 并遵循其中的说明。
• 处理用户与 MatrixScan AR 注释的交互（例如，“用户点按注释时执行……”“响应弹出框按钮的点按”“检测对信息注释标题／页脚的点按”）→ 阅读 references/user-interaction.md 并遵循其中的说明。

注释交互不使用 BarcodeArViewUIDelegate（该代理用于高亮点按）。每种可点按的注释类型都有自己的代理。详见 user-interaction.md。

API 使用政策

仅使用下方 Scandit 参考资料中明确记录的 API。不要编造或猜测方法签名、参数或视图修饰符。如果不确定某个 API 是否存在或如何调用，或遇到编译错误，请先获取相关参考页面再作答。不要让用户自行查阅文档。作答后，务必附上相关链接，方便用户进一步了解。

切勿构造或猜测文档 URL。 需要特定类或属性的 API 页面时：

1. 先检查已获取的页面（例如注释类页面）是否包含指向该页面的直接链接；主题页面会直接链接到相关 API 符号。获取内容时，务必同时请求链接。
2. 如果没有找到直接链接，请获取 API 索引（见下方表格中的 Full API reference），从中提取实际链接并访问该链接。

URL 结构可能有所不同（例如 api/ui/ 子目录）；猜测 URL 会导致 404。

参考资料

使用此表格，根据问题选择要获取的页面，并在回答中附上链接，方便用户进一步了解。不要让用户自行阅读文档。

主题	资源
UIKit 集成	快速入门（UIKit） · 示例
SwiftUI 集成	快速入门（SwiftUI）
完整 API 参考	MatrixScan AR API