Skip to content

跳转URL标准

更新这个文件,记得同时更新Wiki

基础格式(正则形式)

(zaly://|zalys://)?host(:port)?(/goto\?page=name(&params)?)

  • 测试地址

  • Scheme

    • 只能为zaly://或zalys://。
    • 如为空则为zaly://
  • DomainAndPort
    • host: 域名、IP
    • port:数字,可为空(默认值2021)。
  • path
    • 固定死为/goto
    • 如无则跳转到默认页面。
  • query
    • query的第一个参数固定死为page
    • 默认页面为message
    • 其他参数,由具体的页面自己决定。
    • query的参数名称只允许由以下字符组成:
      • a-z,0-9(不允许出现大写字母)
      • (英文半角)下划线

例子:

  • zaly://im.akaxin.com/goto?page=message
  • zaly://im.akaxin.com:2028/goto?page=message
  • zaly://im.akaxin.com/goto?page=u2_msg&site_user_id=abckf-ldksjsdf-1231

支持的跳转页面

消息帧 message

page = message

此页面不需要其他参数,并且可省略path、query部分。

通讯录 contacts

page = contacts

此页面不需要其他参数

个人帧 personal

page = personal

此页面不需要其他参数

二人聊天 u2_msg

page = u2_msg

本页面支持的参数有:

  • site_user_id

群组聊天 group_msg

page = group_msg

本页面支持的参数有:

  • site_group_id

个人资料 user_profile

page = user_profile

本页面支持的参数有:

  • site_user_id

个人资料 group_profile

page = group_profile

本页面支持的参数有:

  • site_group_id

添加好友 request_friend

page = request_friend

本页面支持的参数有:

  • site_user_id
  • request_message
    • 可以为空(如果是中文的话,需要使用encodeURI()编码整个url ,或者使用 encodeURIComponent() 编码这一个参数)

新朋友(好友申请列表) friend_apply

page = friend_apply

本页面支持的参数有:   不需要附带其他参数,在uri中附带站点地址即可

首页扩展 plugin

page = plugin

本页面支持的参数有:

  • plugin_id

单聊界面扩展 plugin_for_u2_chat

page = plugin_for_u2_chat

本页面支持的参数有:

  • plugin_id
  • site_user_id
  • akaxin_param

akaxin_param 的值,将会拼装到 referer里,扩展页面可以通过 HTTP_REFERER 来获取。

群聊界面扩展 plugin_for_group_chat

page = plugin_for_group_chat

本页面支持的参数有:

  • plugin_id
  • site_group_id
  • akaxin_param

akaxin_param 的值,将会拼装到 referer里,扩展页面可以通过 HTTP_REFERER 来获取。

系统浏览器

DomainAndPort = default

page = os_browser

本页面支持的参数有:

  • page_url (需要使用 encodeURIComponent() 函数编码)
  • 可以忽略判断 DomainAndPort

zaly://default/goto?page=os_browser&page_url=www.baidu.com......