Appearance
通用能力
客户端内缓存相关说明
- 客户端缓存是根据响应头内 Cache-Control 来执行缓存策略的,可在页面响应头添加 Cache-Control: no-cache 来实现无缓存状态。
- 客户端在主线版本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 或其他 - 允许分享(默认) |
2 | webview 样式选择 | 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形式在功能页中打开,点击引导栏打开按钮后,将直接唤起客户端并打开目标页面
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')}`