Multi API Call (multiapicall://)
在一次 window.location.href 赋值中调用多个 WebViewGold 数据 API — 非常适合同时使用 iOS 版本的跨平台 Web 应用。
Multi API Call 功能允许您在一次 window.location.href 赋值中触发多个 WebViewGold API。这对跨平台 Web 应用尤其有用:基于 Apple 的浏览器对同一脚本中的多次页面跳转的处理方式与 Android 不同 — 在同一脚本中多次调用 window.location.href = "exampleAPItrigger" 在 Android 上可行,但在 iOS 上不行。使用 multiapicall://,同一份 Web 代码可以在两个平台上运行。
支持作为条目的 API:
- get-uuid
- getonesignalplayerid
- getappversion
- statusbarcolor(后跟三个 RGB 数值条目)
- statusbartextcolor(后跟一个条目:
black或white) - bottombarcolor(后跟三个 RGB 数值条目)
- navbartextcolor(后跟一个条目:
black或white)
使用方法:
用英文逗号(,)分隔 API 名称(以及它们的值,如有)— 不要有空格:
<script> // 示例组合:"getonesignalplayerid" 和 "getappversion" window.location.href = "multiapicall://getonesignalplayerid,getappversion"; </script>
向 Dynamic UI API 传递值的方式如下:
<script> // 将状态栏设为红色、文字颜色设为白色并获取 UUID — 一次调用完成 window.location.href = "multiapicall://statusbarcolor,255,0,0,statusbartextcolor,white,get-uuid"; </script>
注意:在 Android 上,也可以依次调用各个 API(例如先调用 window.location.href = "get-uuid://";,再调用 window.location.href = "getappversion://";)。如果您想与 WebViewGold iOS 版共享同一套代码,请使用 multiapicall://。
点击这里查看该功能的演示网页。检查页面源代码即可查看示例代码。
SDK 风格的实现说明
将此功能视为向 Web 层公开的原生能力:将生产网站或 PWA 作为唯一可信来源,然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用,仅在能够带来价值的地方启用原生 Android 行为。这种方式让代码库易于维护,因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for Android 以及其他 WebViewGold 平台。
为获得可靠的结果,建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态,以及封装原生调用的小型 JavaScript 辅助函数。例如,使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用,可以提供单个按钮或事件处理程序来触发原生 WebViewGold API,同时仍为浏览器提供优雅的回退方案。
- 推荐的集成模式:检测应用上下文,调用 WebViewGold API,然后在原生回调或路由变更后更新 Web 界面。
- 测试清单:在真机或打包构建上验证该功能,检查权限和商店审核文案,并确认仅使用浏览器的用户仍能获得有用的回退方案。
- SEO 优势:让功能页面、路由标题和结构化内容在您的网站上保持可被索引,同时由 WebViewGold 为 Android 用户提供原生应用外壳。