admin9webs
322b7737eb
来源：紫鸟帮助中心/博客/主站资讯 + HubStudio API 文档/帮助中心 + 三个官方 skill 仓库。 只入库 Markdown 与元数据；原始 HTML 与 tarball 留在本机。
89 lines
2.5 KiB
Markdown
89 lines
2.5 KiB
Markdown
# 客户端 Schema URL 协议
|
||
|
||
> 本文件是 ziniao-sso-doc 的 Level 2 参考文档。
|
||
> 仅在需要查阅 superbrowser:// Schema URL 的详细参数与用法时加载。
|
||
|
||
## 概述
|
||
|
||
通过 `superbrowser://` 自定义 URL 协议控制紫鸟浏览器，支持打开/关闭账号和退出程序。
|
||
调用方式有两种：
|
||
|
||
1. **浏览器链接**：在浏览器地址栏打开 `superbrowser://...`（需通过安装程序安装紫鸟）
|
||
2. **命令行**：`SuperBrowser.exe "superbrowser://..."` （需主程序路径正确）
|
||
|
||
---
|
||
|
||
## Action: OpenStrore（打开账号）
|
||
|
||
### 完整示例
|
||
|
||
```
|
||
superbrowser://OpenStrore?storeId=xxxxxxx&openapiToken=xxxxxxxxx&userId=xxxxxxx&lanuchUrl=aHR0cHM6Ly93d3cuYmFpZHUuY29t&autoopen=true&debuggPort=60001¬PromptForDownload=1&forceDownloadPath=Rjpc5a6J6KOF5YyF --disable-gpu start-maximized
|
||
```
|
||
|
||
### 必须参数
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| storeId | 账号 ID |
|
||
| userId | 紫鸟的用户 ID（如果发生变化需要重新登录） |
|
||
| openapiToken | 鉴权 token（通过 `user-login` 接口获取） |
|
||
|
||
> 如果本地已登录紫鸟客户端，且 userId 与本地登录用户一致，openapiToken 可不传（客户端版本 v5.290 或 v6.25 以上）。
|
||
|
||
### 可选参数
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| lanuchUrl | 将要打开的目标地址，需 Base64 编码（如 `https://www.baidu.com` → `aHR0cHM6Ly93d3cuYmFpZHUuY29t`） |
|
||
| autoopen | 设为 `true` 时自动打开 lanuchUrl 配置的地址 |
|
||
| debuggPort | 指定 debug 端口号 |
|
||
| notPromptForDownload | `1`=下载文件不弹出选择路径提示框，直接下载；`0` 或不传则弹出选择路径提示框 |
|
||
| forceDownloadPath | 设置默认下载路径，路径需 Base64 编码 |
|
||
|
||
### 命令行参数
|
||
|
||
命令参数添加在链接后面，用空格隔开，多个参数也用空格隔开。
|
||
|
||
> 添加的命令参数需要向管理员申请使用权限，否则不生效。
|
||
|
||
### 响应结果
|
||
|
||
启动紫鸟浏览器并打开对应账号。
|
||
|
||
---
|
||
|
||
## Action: exit（退出浏览器）
|
||
|
||
### 请求格式
|
||
|
||
```
|
||
superbrowser://exit
|
||
```
|
||
|
||
### 说明
|
||
|
||
退出紫鸟浏览器程序，关闭所有账号。
|
||
|
||
> 如果上次打开的程序未完全退出，下次调用打开账号将会发生异常。建议在重新打开前先调用 exit。
|
||
|
||
---
|
||
|
||
## Action: CloseStrore（关闭账号）
|
||
|
||
### 请求格式
|
||
|
||
```
|
||
superbrowser://CloseStrore?storeId=268682156400
|
||
```
|
||
|
||
### 参数
|
||
|
||
| 参数 | 说明 |
|
||
|------|------|
|
||
| storeId | 要关闭的账号 ID |
|
||
|
||
### 说明
|
||
|
||
关闭指定账号，每次只能关闭 1 个账号。如需关闭多个，需多次调用。
|