触觉反馈 API
从您的 Web 应用触发原生振动触觉反馈,在 Android 上带来原生应用般的体验。
WebViewGold 允许在您的 Web 应用中实现原生的 Android 触觉控制。 使用我们的 API,您可以执行以下操作:
轻度冲击
lighthaptic://
用于小而轻的 UI 元素之间的碰撞
重度冲击
heavyhaptic://
用于大而重的 UI 元素之间的碰撞
成功通知
successhaptic://
表示某项任务或操作已成功完成
警告通知
warninghaptic://
表示某项任务或操作产生了某种警告
错误通知
errorhaptic://
表示发生了错误
下面是一个如何使用该 API 的示例,其中包含一个与我们的触觉 API 交互的锚点标签和自定义 JavaScript 函数。
<a onclick="lightHaptic('index.html')">Navigation Link with Haptics</a>
<script>
function lightHaptic(url) {
if (isWebViewBrowser) {
window.location.href = url;
loadInnerHref("lighthaptic://");
} else {
window.location.href = url;
}
}
function loadInnerHref(url) {
iFrame = document.createElement("iframe");
iFrame.setAttribute("src", url);
document.body.appendChild(iFrame);
iFrame.parentNode.removeChild(iFrame);
iFrame = null;
}
</script>点击此处查看此功能的演示网页。检查该页面即可查看示例代码。
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 用户提供原生应用外壳。