MultiAPICall 功能
借助适用于 iOS 的 MultiAPICall 功能,在单个请求中串联多个 WebViewGold API 调用。
这是一项 iOS 的可选功能,因为基于 Apple 的浏览器处理同一脚本上多次页面重新加载的方式与基于 Android 的浏览器不同。
这意味着在同一网页脚本中多次调用 window.location.href = "exampleAPItrigger" 在 iOS 上将无法正常工作,这与 Android 不同。
MultiAPICall 功能允许您在网页脚本末尾通过单次 window.location.href 赋值调用多个 API。如果您希望从应用中预加载多个数据功能以便在页面上使用,此功能会非常有用。
MultiAPICall 支持以下数据采集 API 作为条目:
"get-uuid", "user-disable-tracking", "getonesignalplayerid", "getappversion", "__haptics (light, medium, heavy, success, warning, error)"
使用 JavaScript 调用此类 URL 即可一次性调用多个 API(请务必加入检测以确保仅在 iOS 平台上使用):
<script>
// Example combination: "getonesignalplayerid" and "getappversion"
if (getMobileOperatingSystem() == "iOS") {
// iOS: Use MultiAPICall feature, separate API names by commas (","), NO spaces
window.location.href = "multiapicall://getonesignalplayerid,getappversion";
} else {
// Android: Can handle multiple calls at once, use normal API call structure
window.location.href = "getonesignalplayerid://";
window.location.href = "getappversion://";
}
</script>点击此处查看此功能的演示网页。检查该页面即可查看示例代码。
SDK 风格的实现说明
将此功能视为向 Web 层公开的原生能力:将生产网站或 PWA 作为唯一可信来源,然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用,仅在能够带来价值的地方启用原生 iOS 行为。这种方式让代码库易于维护,因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for iOS 以及其他 WebViewGold 平台。
为获得可靠的结果,建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态,以及封装原生调用的小型 JavaScript 辅助函数。例如,使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用,可以提供单个按钮或事件处理程序来触发原生 WebViewGold API,同时仍为浏览器提供优雅的回退方案。
- 推荐的集成模式:检测应用上下文,调用 WebViewGold API,然后在原生回调或路由变更后更新 Web 界面。
- 测试清单:在真机或打包构建上验证该功能,检查权限和商店审核文案,并确认仅使用浏览器的用户仍能获得有用的回退方案。
- SEO 优势:让功能页面、路由标题和结构化内容在您的网站上保持可被索引,同时由 WebViewGold 为 iOS 用户提供原生应用外壳。