协议启动
通过 rodelplayer:// 协议链接快速创建连接器配置
小幻影视注册了 rodelplayer:// 协议头，第三方工具或网页可以通过协议链接把连接器配置直接推到应用里，省去用户手动填写表单的过程。
创建配置
格式：rodelplayer://import?...
应用解析 URI 时会读取 Host=import 和查询字符串里的参数，然后根据 type 走对应的连接器创建逻辑。导入成功前会弹一个确认对话框（除非用户在「设置」里勾选了「跳过协议导入确认」）。
通过协议创建的配置不会再做有效性验证，参数错误会导致连接器创建后无法登录。请确保参数本身合法、且服务器可达。
所有查询参数必须经过 URL 编码——应用解析协议链接的前提是它本身就是一个合法 URL，特别注意 password、scheme、自定义 line{n} 中的 :// 等部分。
通用参数
以下参数所有类型通用：
| 参数 | 说明 | 必填 |
|---|---|---|
type | 连接器类型，见下表 | 是 |
title | 配置名称，留空时按类型 + 时间戳生成（如 Emby-20260424_120000） | 否 |
icon | 配置图标，仅支持 http(s) 协议的图片地址，其它形式会被忽略 | 否 |
支持的 type 取值：emby / jellyfin / webdav / smb / alist / openlist。
Emby / Jellyfin
rodelplayer://import?type=emby&title=MyEmby&scheme=http&host=xxx.xxx.com&port=8096&username=xxx&password=xxx| 参数 | 说明 | 必填 |
|---|---|---|
scheme | 协议头，http 或 https | 是 |
host | 域名或 IP | 是 |
port | 端口；留空时按 scheme 取默认端口（http=80，https=443） | 否 |
path | 反代路径 | 否 |
username | 用户名 | 是 |
password | 密码 | 否 |
多线路（备用线路）：每条线路用 line{index} + line{index}title 一对参数表示，序号从 1 开始且必须连续；基础参数（scheme/host/port/path）描述的是默认主线路。
rodelplayer://import?type=emby&...&line1=http%3A%2F%2F127.0.0.1%3A8096&line1title=LocalWebDAV
rodelplayer://import?type=webdav&title=MyWebDAV&scheme=http&host=xxx.xxx.com&path=dav&port=5244&username=xxx&password=xxx| 参数 | 说明 | 必填 |
|---|---|---|
scheme / host / port / path | 同 Emby | scheme/host 必填 |
username / password | 凭据 | 否 |
SMB
rodelplayer://import?type=smb&title=MySMB&host=192.168.1.10&username=xxx&password=xxx| 参数 | 说明 | 必填 |
|---|---|---|
host | IP 或主机名 | 是 |
username / password | 凭据 | 否 |
SMB 走标准 445 端口，无需自定义。
Alist / OpenList
type 用 alist 或 openlist 区分；其它参数完全一致。
rodelplayer://import?type=alist&title=MyAlist&scheme=http&host=xxx.xxx.com&port=5244&username=xxx&password=xxx| 参数 | 说明 | 必填 |
|---|---|---|
scheme / host / port / path | 同 Emby | scheme/host 必填 |
username / password | 凭据 | 是 |
添加图标源
格式：rodelplayer://import-icon?url={图标源 URL}
应用会拉取该 URL 上的图标包 JSON（结构需符合内置图标源响应格式：{ name, description, icons: [{ name, url }] }），通过校验后写入图标源列表，下次打开图标选择器即可看到。与连接器导入共用「跳过协议导入确认」开关。
| 参数 | 说明 | 必填 |
|---|---|---|
url | 图标包 JSON 的 http(s) 直链，必须 URL 编码 | 是 |
title | 自定义图标源名称；留空时取响应里的 name 字段 | 否 |
rodelplayer://import-icon?url=https%3A%2F%2Fexample.com%2Ficons.json拉取或解析失败、URL 不合法时会直接弹失败 toast，不会写入数据库；同 URL 重复导入会覆盖已有的名称和描述。
跳过确认对话框
默认每次协议导入都会弹出确认对话框列出即将创建的服务名。如果你的工作流大量调用协议链接，可在「设置 → 通用 → 跳过协议导入确认」开启免确认（开启后协议链接会直接创建连接器，请慎用）。