教程 框架 组件 接口 其他

URL 跳转配置

URL 跳转配置是指在 H5 页面中可以通过调用接口跳转到应用。

接入方式

使用本功能,需要在网页中嵌入以下 js,支持 HTTP 与 HTTPS 访问。

<script type="text/javascript" src="//statres.quickapp.cn/quickapp/js/routerinline.min.js"></script>

注意:appRouter 和 channelReady 方法需要在 body 标签内调用,不支持在 head 标签里调用。(直接调用或引入外部 JS 文件调用均可)

调起应用

appRouter(packageName, path, params, confirm)

参数:

参数名类型必填说明
packageNameString配置跳转快应用的包名,包名和 manifest.json 的"package"属性保持一致。
pathString配置跳转的页面路径,对应 manifest.json 中 router 下 page 的 path 字段。
如果不传 path 值或 path 值为空字符串,跳转时会打开首页
详情请参见manifest 文档的"router.page"一节
paramsObject配置透传给快应用页面的参数。
如果不传 params,会默认使用当前加载此 appRouter 函数的网页 url 的参数值作为 params 的值。
通过 params 传入的参数值,会赋值到当前快应用页面的 public 同名字段
详情请参见deeplink 文档中"快应用获取 key-value"一节
confirmString配置在跳转确认弹窗中显示的文案。
当 confirm 值被框架转换为 Boolean 类型,且结果值为 false 时,如 confirm 值为空字符串、undefined、null等,表示无需用户确认直接跳转;否则,表示跳转时需要用户确认,且弹框显示 confirm 文案。

示例

<!DOCTYPE html>
<html>
  <head>
    <title>URL跳转配置</title>
    <script
      type="text/javascript"
      src="//statres.quickapp.cn/quickapp/js/routerinline.min.js"
    ></script>
  </head>
  <body>
    <!-- 调起应用 -->
    <script type="text/javascript">
      // 需要在body标签里实现 appRouter 方法的调用
      // 通过script标签引入routerinline.min.js后, appRouter函数会绑定到window上,因为是全局函数,所以可直接引用
      // *** 注意 *** 此处 appRouter 两个示例选"其中一个"拷贝运行,即可查看效果

      // 无需用户确认的调用方式,只传入三个参数
      // 包名格式为 'xxx.yyy.zzz',包名和 manifest.json 的"package"属性保持一致。
      // 路径格式为 'aa/bb/cc', 对应 manifest.json 中 router 下 page 的 path 字段。
      // 透传参数类型为对象,快应用页面可通过 public 属性获取
      appRouter('xxx.yyy.zzz',
                   'Home/Video',
                   { a: 2, b: 'efg' })

      // 需要用户确认的调用方式,需传入四个参数
      // appRouter 第4个参数填入需要显示的文案
      appRouter('xxx.yyy.zzz',
                'Home/Audio',
                { a: 1, b: 'abc' },
                'Quick App Demo')

    </script>
  </body>
</html>

支持明细

厂商支持版本备注
小米1000+-
中兴--
华为1010+需 EMUI 8.2+;
暂不支持 confirm 参数
金立--
联想--
魅族--
努比亚1000+-
OPPO1000+需 ColorOS 2.1 以上支持
vivo1000+-
一加1040+需 Android 10+ 支持
海信1030 -

检测平台是否支持服务

channelReady(callback)

参数:

参数名类型必填说明
callbackfunction平台上快应用能力检测的回调函数,如支持快应用服务则返回 true 值,否则则返回 false 值

示例

<!DOCTYPE html>
<html>
  <head>
    <title>URL跳转配置</title>
    <script
      type="text/javascript"
      src="//statres.quickapp.cn/quickapp/js/routerinline.min.js"
    ></script>
  </head>
  <body>
    <!-- 检测平台是否支持服务 -->
    <script type="text/javascript">
      // 需要在body标签里实现 channelReady 方法的调用
      // 通过script标签引入routerinline.min.js后, channelReady函数会绑定到window上,因为是全局函数,所以可直接引用
      // 通过传递回调函数获取结果,平台支持快应用则返回true,不支持则返回false
      channelReady(function(bAvailable) {
        alert('是否存在框架服务:' + bAvailable)
      })
    </script>
  </body>
</html>

支持明细

厂商支持版本备注
小米1000+需 MIUI 稳定版 v9.5+ 或 开发版 8.2+
中兴--
华为-华为所有安卓设备 channelReady 都会返回 true 值
金立--
联想--
魅族--
努比亚--
OPPO1000+需 ColorOS 2.1 以上支持
vivo1000+需 Android 8.0 及以上机型支持
一加1040+需 Android 10+ 支持
海信1030 -

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容