# scheme 协议

# 应用外打开私聊会话

通过 scheme 在应用外打开私聊会话

# 使用说明

# 187 版本以下

  // pc 端示例代码
  // 线上环境,sessionid 为用户企业唯一标识id
  window.location.href = 'yach://yach.zhiyinlou.com/session/sessionp2p?sessionid=Yach228346'
  // 测试环境,sessionid 为用户企业唯一标识id
  window.location.href = 'yachtest://yach.zhiyinlou.com/session/sessionp2p?sessionid=Yach228346'

  // 移动端示例代码
  // sessionid 为对应环境下知音楼用户id(不同于用户企业唯一标识id)
  window.location.href = 'yach://yach.zhiyinlou.com/session/sessionp2p?sessionid=228346'

# 187 版本及以上版本优化,保持拼接字段sessionid数据统一(向下兼容,依然支持187 版本以下方式)

  // pc 端示例代码
  // 线上环境,sessionid 为用户企业唯一标识id
  window.location.href = 'yach://yach.zhiyinlou.com/session/p2p?sessionid=Yach228346'
  // 测试环境,sessionid 为用户企业唯一标识id
  window.location.href = 'yachtest://yach.zhiyinlou.com/session/p2p?sessionid=Yach228346'

  // 移动端示例代码
  // sessionid 为对应环境下用户企业唯一标识id
  window.location.href = 'yach://yach.zhiyinlou.com/session/p2p?sessionid=Yach228346'

# 参数说明

参数 参数值 必传 说明
scheme 线上:yach://;测试:yachtest:// 协议
host yach.zhiyinlou.com 与移动端保持一致
path /session/sessionp2p 对应打开私聊的路径
params sessionid 用户企业唯一标识id

# 应用外打开群聊会话

通过 scheme 在应用外打开群聊会话,知音楼版本 >= 1.4.2.11仅支持 pc

# 使用说明

  // 线上环境,sessionid 为线上环境群聊会话 id
  window.location.href = 'yach://yach.zhiyinlou.com/session/sessiongroup?sessionid=2819739271'
  // 测试环境,sessionid 为测试环境群聊会话 id
  window.location.href = 'yachtest://yach.zhiyinlou.com/session/sessiongroup?sessionid=2819739271'

# 参数说明

参数 参数值 必传 说明
scheme 线上:yach://;测试:yachtest:// 协议
host yach.zhiyinlou.com 与移动端保持一致
path /session/sessiongroup 对应打开群聊的路径
params sessionid 会话 ID,群聊对应为群 ID

# 应用内打开工作台侧边栏(移动端应用外可以该scheme拉起知音楼并打开webview页面)

使用侧边栏打开链接
测试方法:1、在将链接作为消息发送出去,点击即可在侧边栏打开。2、消息体内含有按照规则构造链接,发送消息卡片,点击此消息卡片。
应用场景:markdown、action_card 消息卡片点击打开等。

# 使用说明

  // 线上环境
  'yach://yach.zhiyinlou.com/session/webview?url=https%3A%2F%2Fyach-open-doc-dev.zhiyinlou.com&pc_slide=true&hide_title_bar=true'
  // 测试环境
  'yachtest://yach.zhiyinlou.com/session/webview?url=https%3A%2F%2Fyach-open-doc-dev.zhiyinlou.com&pc_slide=true&hide_title_bar=true'

# 参数说明

参数 参数值 必传 说明
scheme 线上:yach://;测试:yachtest:// 协议
host yach.zhiyinlou.com 与移动端保持一致
path /session/webview 对应打开侧边栏 webview 的路径
params pc_slide 值为 true,指定链接在 im 侧边栏打开(注意:不要转码这个!),与 workbench_slide 不共存
workbench_slide 值为 true,指定链接在工作台侧边栏打开(注意:不要转码这个!),与 pc_slide 不共存
hide_title_bar 侧边栏是否隐藏 title,默认为 false,不隐藏,知音楼版本 >= 1.4.9.x
url 要在侧边栏打开的链接

# 应用内打开独立窗口

使用独立窗口打开页面链接,知音楼版本 >= 1.5.0.x仅支持 pc
测试方法:1、在将链接作为消息发送出去,点击即可使用独立窗口打开;2、消息体内含有按照规则构造链接,发送消息卡片,点击消息卡片。
应用场景:action_card 消息卡片点击打开等。

# 使用说明

  // 线上环境
  'yach://yach.zhiyinlou.com/session/webview?url=https%3A%2F%2Fyach-open-doc-dev.zhiyinlou.com&single_webview=true&title=true'
  // 测试环境
  'yachtest://yach.zhiyinlou.com/session/webview?url=https%3A%2F%2Fyach-open-doc-dev.zhiyinlou.com&single_webview=true&title=true'

# 参数说明

参数 参数值 必传 说明
scheme 线上:yach://;测试:yachtest:// 协议
host yach.zhiyinlou.com 与移动端保持一致
path /session/webview 对应打开独立窗口 webview 的路径
params single_webview 值为 true,使用独立窗口打开页面(注意:不要转码这个!)
title 独立窗口 title
url 要在独立窗口打开的链接

# 应用内、外打开工作台 tab 页

应用场景:应用内 markdown 链接、应用外浏览器唤起,知音楼版本 >= 1.4.4.x仅支持 pc

# 使用说明

  // 线上环境
  'yach://yach.zhiyinlou.com/workbench/tabopen?id=test&url=https%3A%2F%2Fyach.zhiyinlou.com%2F&title=title'
  // 测试环境
  'yachtest://yach.zhiyinlou.com/workbench/tabopen?id=test&url=https%3A%2F%2Fyach.zhiyinlou.com%2F&title=title'

# 参数说明

参数 参数值 必传 说明
scheme 线上:yach://;测试:yachtest:// 协议
host yach.zhiyinlou.com 与移动端保持一致
path /workbench/tabopen 对应打开工作台的路径
params id 工作台 tab 的唯一标识
url 要在工作台打开的 tab 链接
title tab 栏标题(注意:不要转码这个!)

# 应用外打开文档

通过 scheme 在应用外打开知音楼某个文档,知音楼版本 >= 1.5.2.x仅支持 pc

# 使用说明

  // 线上环境
  window.location.href = 'yach://yach.zhiyinlou.com/doc/open?url=https%3A%2F%2Fyach-doc-shimo.zhiyinlou.com%2Fdocs%2FrgQX3gHhvJPQvwRY%2F'
  // 测试环境
  window.location.href = 'yachtest://yach.zhiyinlou.com/doc/open?url=https%3A%2F%2Fyach-doc-shimo-test.zhiyinlou.com%2Fdocs%2FrgQX3gHhvJPQvwRY%2F'

# 参数说明

参数 参数值 必传 说明
scheme 线上:yach://;测试:yachtest:// 协议
host yach.zhiyinlou.com 与移动端保持一致
path /doc/open 对应打开文档的路径
params url 文档地址,地址需要做编码处理

# 补充说明

  1. 测试包对应的文档域名:yach-doc-shimo-test.zhiyinlou.com
  2. 线上包对应的文档域名:yach-doc-shimo.zhiyinlou.com
  3. 包和文档域名不对应不能正常打开文档
上次更新: 3/29/2024, 11:31:58 AM
foo