新闻详情

新闻详情

首页 / 资讯中心 / 详情

H5 调用 Android 接口扫描手机图片:TaoToken 统一 Key 配置与联调骨架

发布时间:2026/11/17 9:31:04来源:尧图网络
H5 调用 Android 接口扫描手机图片:TaoToken 统一 Key 配置与联调骨架
1. H5 调用 Android 接口扫描手机图片先搞清楚要解决什么H5 调用 Android 接口扫描手机图片本质是让网页里的 JavaScript 通过 WebView 提供的桥接能力去调用 Android 原生的 MediaStore 查询接口把本地相册里的图片路径、名称、尺寸、拍摄时间等元数据回传给前端渲染。它适合混合开发场景你有一个已经跑在 WebView 里的 H5 页面不想重写原生界面但又需要读取用户手机里的图片列表。核心难点不在“查图片”本身而在三件事运行时权限申请、跨线程回调桥接、以及把散落的接口调用收敛到一套可维护的配置里。我试过直接在 H5 里用plus.android那套写法能跑通但一旦项目里出现多个原生能力扫码、定位、文件、图片每个页面各写一份 importClass维护起来很痛苦。所以这篇给的是一个更工程化的骨架Android 侧用addJavascriptInterface暴露一个受控接口H5 侧只认一个全局对象同时把模型/接口调用需要的统一 Key 放进config.toml让联调阶段不用来回改代码。下面从权限片段开始一路给到真机验证扫描回调的完整步骤。2. TaoToken 统一 Key 前置为什么联调阶段要先把它配好扫描图片只是本地能力为什么还要提 TaoToken因为真实项目里H5 拿到图片列表后往往紧接着要做识别、分类、生成描述这类模型调用。如果本地扫描和模型调用是两套 Key、两套地址联调时你会花大量时间在“到底是权限没给还是 Key 没配对”之间反复横跳。TaoToken 提供的是统一入口把模型对话、编码计划、控制台、API Key 管理收敛到一处H5 和 Android 侧共用同一份配置即可。你需要先拿到一个可用的 Key入口在控制台的 API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。拿到之后不要硬编码进 H5而是写进工程根目录的config.toml由构建脚本注入或由原生侧读取后通过桥接传给 H5。这样做的直接好处是换环境只改一个文件扫描回调里带的调试信息也能统一带上请求标识排查时一眼能对上。接口基地址统一用 https://taotoken.net/api 注意这个地址不带任何查询参数拼接路径时自己补全。模型对话的调试页面在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 联调扫描结果后想顺手验证一下模型能不能吃这些图片元数据可以直接在那里试。长期做编码和 Agent 类任务的看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。config.toml示例字段名按你项目习惯改关键是分层清晰[app] name h5-android-scan debug true [taotoken] base_url https://taotoken.net/api api_key sk-你的Key timeout_ms 30000 [scan] # 单次扫描最多返回多少张防止大相册卡死 WebView max_items 500 # 是否在回调里附带缩略图 base64真机联调建议先关 with_thumbnail false注意api_key不要提交到公开仓库用.gitignore排除config.toml仓库里放一份config.example.toml。3. 可复制配置AndroidManifest 权限片段与 WebView 桥接骨架3.1 权限片段Android 13API 33之后读媒体权限拆分了图片要用READ_MEDIA_IMAGES低版本仍用READ_EXTERNAL_STORAGE。两个都写上用maxSdkVersion控制生效范围uses-permission android:nameandroid.permission.READ_EXTERNAL_STORAGE android:maxSdkVersion32 / uses-permission android:nameandroid.permission.READ_MEDIA_IMAGES /如果你还要读视频或音频再补READ_MEDIA_VIDEO、READ_MEDIA_AUDIO。别偷懒写MANAGE_EXTERNAL_STORAGE那个权限审核很麻烦图片场景用不上。3.2 WebView 与 addJavascriptInterface 骨架原生侧暴露一个类方法上必须加JavascriptInterface否则 H5 调不到。查询放到子线程结果通过webView.post回主线程再evaluateJavascript回调避免在 JS 桥线程里做耗时 IOpublic class ScanBridge { private final Context ctx; private final WebView webView; public ScanBridge(Context ctx, WebView webView) { this.ctx ctx; this.webView webView; } JavascriptInterface public void scanImages(final String callbackId) { new Thread(() - { ListMapString, Object list new ArrayList(); String[] projection { MediaStore.Images.Media._ID, MediaStore.Images.Media.DISPLAY_NAME, MediaStore.Images.Media.DATA, MediaStore.Images.Media.DATE_TAKEN, MediaStore.Images.Media.WIDTH, MediaStore.Images.Media.HEIGHT }; try (Cursor c ctx.getContentResolver().query( MediaStore.Images.Media.EXTERNAL_CONTENT_URI, projection, null, null, MediaStore.Images.Media.DATE_TAKEN DESC)) { if (c ! null) { int max 500; while (c.moveToNext() list.size() max) { MapString, Object item new HashMap(); item.put(name, c.getString(c.getColumnIndexOrThrow( MediaStore.Images.Media.DISPLAY_NAME))); item.put(path, c.getString(c.getColumnIndexOrThrow( MediaStore.Images.Media.DATA))); item.put(date, c.getLong(c.getColumnIndexOrThrow( MediaStore.Images.Media.DATE_TAKEN))); item.put(width, c.getInt(c.getColumnIndexOrThrow( MediaStore.Images.Media.WIDTH))); item.put(height, c.getInt(c.getColumnIndexOrThrow( MediaStore.Images.Media.HEIGHT))); list.add(item); } } } String json new Gson().toJson(list); webView.post(() - webView.evaluateJavascript( window.__onScanResult( callbackId , json ), null)); }).start(); } }注册桥接时给一个固定名字H5 侧就认这个名字webView.getSettings().setJavaScriptEnabled(true); webView.addJavascriptInterface(new ScanBridge(this, webView), AndroidScan);3.3 H5 侧调用与回调H5 不再直接 importClass而是调用桥接对象用 callbackId 做请求配对避免多次扫描结果串台let seq 0; const pending {}; window.__onScanResult function (callbackId, list) { const cb pending[callbackId]; if (cb) { cb(list); delete pending[callbackId]; } }; function scanImages() { return new Promise((resolve) { const id scan_ (seq); pending[id] resolve; if (window.AndroidScan window.AndroidScan.scanImages) { window.AndroidScan.scanImages(id); } else { resolve([]); // 非 Android 环境降级 } }); } document.getElementById(btn).addEventListener(click, async () { const list await scanImages(); document.getElementById(result).innerText JSON.stringify(list, null, 2); });3.4 运行时权限申请Manifest 声明只是“有资格申请”真正读之前还要动态申请。在调用scanImages前先检查并请求if (Build.VERSION.SDK_INT 33) { requestPermissions(new String[]{Manifest.permission.READ_MEDIA_IMAGES}, 1001); } else { requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 1001); }H5 侧最好在按钮点击后先触发一次权限检查原生把结果通过另一个桥接方法回传再决定是否发起扫描。这样用户拒绝权限时页面能给出明确提示而不是拿到一个空数组干瞪眼。4. 验证请求与成功结果真机扫描回调怎么确认跑通配置写完别急着接模型先把扫描链路单独验证。步骤按顺序来第一步真机安装后打开 H5 页面点击“获取所有图片”按钮。此时如果权限没给系统会弹窗允许后再次点击。第二步看 Android Studio 的 Logcat过滤chromium或你自己的 TAG确认evaluateJavascript被调用。如果没有任何输出八成是addJavascriptInterface没注册成功或者方法漏了JavascriptInterface。第三步看页面#result区域。成功时应该是一段 JSON 数组每项包含name、path、date、width、height。真机上通常能看到几十到几百条按拍摄时间倒序。第四步验证回调配对。快速连点三次按钮观察结果是否每次都正确刷新没有出现旧结果覆盖新结果。如果串台检查callbackId是否每次递增且pending正确删除。第五步把扫描结果里的一条path拿去模型对话页面做一次简单调用确认config.toml里的base_url和api_key生效。模型对话入口https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。这一步能同时验证本地扫描和统一 Key 两条链路联调效率最高。成功结果的特征很明确Logcat 无SecurityException页面 JSON 非空连续点击结果稳定模型调用返回正常。四个都满足骨架就算立住了。5. 本篇常见错排查扫描为空、回调不触发、权限被拒扫描结果为空数组。最常见原因是权限没真正授予或者 Android 13 上只声明了READ_EXTERNAL_STORAGE而没声明READ_MEDIA_IMAGES。先在系统设置里确认应用有“照片和视频”权限再检查 Manifest 合并结果。另一个原因是查询用了DATA字段部分新机型上该字段可能为空改用_ID拼content://media/external/images/media/{id}更稳。H5 调用后回调不触发。先确认addJavascriptInterface的对象名和 H5 里写的一致大小写敏感。再确认方法签名是public且带JavascriptInterface。如果用了混淆记得给桥接类加 keep 规则否则方法名被改掉H5 调不到。还有一种情况是evaluateJavascript里的 JSON 字符串包含单引号导致拼接断裂用Gson序列化后做一次转义或者改用JSONObject.quote。权限弹窗不出现。检查是否在onCreate之外过早调用或者requestPermissions的 requestCode 被其他地方复用。另外用户勾选“不再询问”后再次请求不会弹窗需要引导去设置页。H5 侧要能区分“用户拒绝”和“系统不再询问”前者可以重试后者只能跳设置。大相册导致 WebView 卡顿。一次回传几百条带 base64 缩略图的数据主线程会明显掉帧。config.toml里的with_thumbnail默认关掉max_items限制在 500 以内。需要缩略图就分页拉取别一次性全塞。Key 配置不生效。确认config.toml被正确读取base_url结尾没有多余斜杠api_key没有前后空格。如果 H5 侧也要用通过桥接把配置传过去别在 JS 里再写一份。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 字段和错误码对照着看更快。6. 把扫描骨架接进你的工程下一步怎么走到这里权限片段、桥接骨架、config.toml、真机验证步骤都齐了。你可以先把扫描链路单独跑通确认 JSON 结构符合预期再往上叠模型调用。统一 Key 的价值在联调后期才明显当扫描、识别、生成描述三条链路共用一份配置时换环境、换 Key、加超时都只动一个文件。如果你主要在做接入和排障先把 API Keys 和接入文档过一遍https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 和 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。如果你要验证模型对图片元数据的处理效果去模型对话页面直接试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。长期做编码和 Agent 的Coding Plan 在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。最后给一个实用技巧把callbackId的生成规则和日志 TAG 统一扫描回调里带上callbackId和耗时出问题时 Logcat 一搜就能定位是权限、查询还是回调环节。这个习惯在混合开发里能省掉大量“猜”的时间。
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/17 7:04:08

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/17 5:42:44

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/16 19:23:38

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/17 6:55:04

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/17 5:57:47

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/16 17:28:18

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉