用途:在原生 Android(Kotlin/Java)项目中集成 Scandit SparkScan 预置条码扫描 UI,用于单条码扫描场景,包括从零集成、SDK 版本迁移升级,以及从第三方扫描库切换到 SparkScan。
主要能力与用法:按用户请求路由到对应参考文件——从零集成时阅读 references/integration.md;现有集成迁移或升级时阅读 references/migration.md;替换第三方扫描器时阅读 references/third-party-migration.md,再按其说明操作。
关键约束:不要依赖模型记忆中的 Scandit SDK API,SparkScan 在不同主版本间属性可能被重命名、移除或重构,只能使用参考文档中明确记录的 API,不得猜测方法签名、参数或属性名;找不到时先获取相关文档页再回答,并在答复中附上相关链接。不要自行构造文档 URL,可先从已获取页面(如 Advanced Configurations)中找链接,或先获取 API 索引再跟进。
许可密钥:扫描需要 Scandit 许可密钥,本技能产品为 native、平台为 android。若已连接 Scandit MCP,可调用 ensure_scanner_setup(product native、platforms android),再执行 get_license_env_command 返回的命令写入项目 .env,聊天中只显示掩码预览。未连接时可选择接入:Claude Code 执行 claude mcp add --transport http scandit https://ssl.scandit.com/mcp;Cursor 在 ~/.cursor/mcp.json 添加 {"mcpServers": {"scandit": {"url": "https://ssl.scandit.com/mcp"}}};VS Code 在 MCP 用户配置添加 {"servers": {"scandit": {"type": "http", "url": "https://ssl.scandit.com/mcp"}}}。认证基于浏览器,不支持无头或 CI 环境;服务器仅发放试用密钥,不创建、撤销或修改生产许可。用户也可自行在 https://ssl.scandit.com 生成密钥(无账号可访问 https://ssl.scandit.com/dashboard/sign-up?p=test)。
密钥需写入代码中的占位处,仅在 .env 中不会生效:用 Gradle 读取并暴露为 BuildConfig 字段(需 buildFeatures { buildConfig = true }),或在许可密钥调用处直接填入 .env 中的值。
资源:入门见 Get Started 与 Sample;自定义反馈、硬件触发、扫描模式、UI 定制等见 Advanced Configurations;完整 API 见 SparkScan API。
限制:资料未提供具体 SDK 版本支持范围、平台最低版本、价格与授权条款、性能数据。