深度链接

运行机制

深度链接可以让用户从浏览器打开启动器或启动器的指定选项卡和页面。部分深度链接支持从浏览器向游戏传输数据

注:
使用深度链接有以下前提条件:
  • 用户计算机上已安装启动器。
  • 用户至少打开过启动器一次。

如何获取

要从浏览器或外部应用程序中打开启动器,请按照下方表格将链接之一放在href属性中。链接中的<launcher-id><game-id><tab-id>是启动器、游戏和选项卡的ID。要找到这些值:

  1. 在发布商帐户中打开您的项目,然后前往分发 > 启动器部分。
  2. 在仪表板上找到启动器,然后单击编辑启动器
  3. 前往内容部分。
  4. 单击选项卡
  5. 在选项卡右边的下拉列表中,单击编辑
  6. 从选项卡编辑页的URI中复制这些值:https://publisher.xsolla.com/\/projects/\/new-launcher/\/game/\/tabs/\

注:
如果深度链接中指定的路径无效,则将打开启动器或激活启动器窗口(如启动器已打开)。
链接描述
xl-<launcher-id>://open打开启动器或激活启动器窗口(如启动器已打开)。
xl-<launcher-id>://game/<game-id>打开主游戏页面。
支持从浏览器向游戏传输数据
xl-<launcher-id>://game/<game-id>/news打开游戏新闻选项卡或主游戏页面(如新闻页面不可用)。
支持从浏览器向游戏传输数据
xl-<launcher-id>://game/<game-id>/store打开游戏商店选项卡或主游戏页面(如商店不可用)。
支持从浏览器向游戏传输数据
xl-<launcher-id>://game/<game-id>/tab/<tab-id>打开游戏页面上的一个自定义选项卡或主游戏页面(如自定义选项卡不可用)。
支持从浏览器向游戏传输数据
xl-<launcher-id>://settings打开启动器设置页面。
xl-<launcher-id>://tab/<tab-id>打开启动器中的一个自定义选项卡或主游戏页面(如自定义选项卡不可用)。
xl-://game/?action=start启动游戏。若有可用更新,会先更新游戏再自动启动。若有游戏选项弹窗则会打开。游戏未安装时会显示安装弹窗。
  • xl-<launcher-id>://game/<game-id>?action=install
  • xl-<launcher-id>://game/<game-id>?action=install&force=1
  • xl-<launcher-id>://game/<game-id>?action=install&force=true
启动或提示安装,可包含以下参数:
  • force=1force=true可跳过用户提示(如已允许)。
  • path参数指定游戏的安装目录。如果未传入该参数且启动器设置中未指定安装路径,则根据操作系统使用以下默认安装路径:
    • Windows — C:\Games\
    • macOS — /Users/{username}/Library/Application Support/
如果force=1force=true,且传入了path参数,则游戏将自动安装到指定目录。
如果路径无效或无法访问,安装模态窗口中会显示错误,并恢复启动器窗口。
如果force=0force=false或未传递,且传入了path参数,则安装模态窗口会打开并预填充指定路径。用户可在确认前修改该路径。
xl-://game/?action=update若有可用更新,将更新游戏。
xl-://game/?action=repair若游戏已下载且无可用更新,将修复游戏。
xl-://game/?action=uninstall若游戏已安装,将执行卸载。
示例:
Copy
Full screen
Small screen
1 <a href="xl-2484://settings">Open launcher-settings</a>
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2026年4月13日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至doc_feedback@xsolla.com与我们联系。