Skip to content

通用能力

客户端内缓存相关说明

  1. 客户端缓存是根据响应头内 Cache-Control 来执行缓存策略的,可在页面响应头添加 Cache-Control: no-cache 来实现无缓存状态。
  2. 客户端在主线版本v7.1.0新增根据链接参数清除缓存功能,只需在链接上拼接参数noCache=1,关闭当前webview后会清除掉缓存,下次进入会重新请求数据。客户端版本信息可通过JS-SDK查询

示例:

txt
https://example.com/path/test.html?noCache=1

返回客户端首页

首页路由:

txt
https://vapp.tmuyun.com/Main_Activity

在客户端webview内直接打开上面的首页路由地址,客户端会返回到客户端首页。

客户端链接参数相关

参数名:gaze_open

该参数用于判断h5页面的打开方式是当前页面打开还是新开页面打开。若为1则是新开页面打开。

示例:

txt
https://example.com/path/test.html?gaze_open=1

参数名:gaze_control

示例:

txt
https://example.com/path/test.html?gaze_control=02
位数(高位优先)配置项枚举说明
1是否允许分享0 - 不允许分享
1 或其他 - 允许分享(默认)
2webview 样式选择1 或其他 - 在带导航栏的 webview 样式中打开(默认)
2 - 在不带导航栏的 webview 样式中打开
3状态栏样式选择1 或其他 - 白底黑字(默认)
2 - 透明黑字
3 - 透明白字

客户端唤起功能页

该功能页面的使用,仅提供给配置分享域名后使用。即自行购买域名后,解析过来给稿件分享使用,此分享域名可使用下述唤醒功能页
参数名称说明
域名配置的分享域名
tenantId用于获取客户端唤起信息
backUrl
link
唤起到客户端打开的目标页面地址,传参不同页面展示效果不同,同时传参优先展示backUrl风格页面。请 encodeURIComponent 后使用
title用于页面标题和分享卡片上的标题
desc分享卡片第二行文案
img分享卡片图片,不传则默认使用客户端logo

功能页拼接方式:

javascript
`https://${分享域名}/webPrivate/jumpApp?tenantId=${租户id}&backUrl=${encodeURIComponent(目标页面地址)}&title=${页面标题}&desc=${第二行分享文案}$img=${分享卡片图片}`

backUrl 类型页面,目标页面将直接以iframe形式在功能页中打开,点击引导栏打开按钮后,将直接唤起客户端并打开目标页面 backUrl 类型页面

link 类型页面,点击打开客户端,直接唤起客户端并打开目标页面 link 类型页面

跳转微信小程序

该功能提供从客户端直接跳转到微信小程序能力,只需要在客户端webview内打开参数拼接正确的链接,即可直接跳转到对应的小程序页面

javascript
// 小程序原始ID
`originalId=${'gh_7******55cf'}`

// 小程序页面路径,可拼接参数,一定要 encodeURIComponent 处理
`path=${encodeURIComponent('/pages/index?key=value&key2=value2')}`

// 在客户端webview内打开参数拼接完整的链接,即可跳转到对应的小程序页面
`https://vapp.tmuyun.com/openMiniProgram?originalId=${'gh_7******55cf'}&path=${encodeURIComponent('页面路径')}`

// 或使用自有域名拼接跳转链接
`https://${自有域名}/openMiniProgram?originalId=${'gh_7******55cf'}&path=${encodeURIComponent('页面路径')}`

跳转支付宝小程序

客户端内跳转支付宝小程序方法,具体可参考支付宝官方文档

javascript
// 要跳转的目标小程序 APPID
`appId=2018062060350751`

// 要跳转到目标小程序的具体 page 页面,路径中可以在 ?后面附加跳转后的页面参数。页面参数必须进行 UrlEncode 编码
`page=${encodeURIComponent('pages/index/index?key1=1&key2=2')}`

// 从外部 App 携带的参数透传到目标小程序,如果不需要携带参数给小程序,可以不带该参数。必须进行 UrlEncode
`query=${encodeURIComponent('key1=value1&key2=value2')}`

// 在客户端webview内打开参数拼接完整的scheme链接,即可跳转到对应的小程序页面
`alipays://platformapi/startapp?appId=2018062060350751&page=${encodeURIComponent('pages/index/index?key1=1&key2=2')}&query=${encodeURIComponent('key1=value1&key2=value2')}`