• 旧版 /open：保留给已有的 Apple 平台接入，支持打开视频和外部字幕。
• 新版 /play：基于 x-callback-url，支持指定起播位置，并在退出播放时返回播放进度和状态。

新版 /play 支持以下平台：

• iPhone 和 iPad
• Apple TV
• Mac
• Android Mobile
• Android TV

新接入请优先使用 /play。已有 Apple 平台的 /open 调用仍可继续使用；Android Mobile 和 Android TV 目前只支持新版 /play。

平台支持

两种调用方式的区别

旧版方式：/open

旧版调用地址：

open-vidhub://x-callback-url/open

旧版 /open 用于兼容已有的 Apple 平台接入，不适用于 Android。

参数

基础示例

open-vidhub://x-callback-url/open?url=http%3A%2F%2Flocalhost%3A8080%2Fsample.mp4&on-success=some-app%3A%2F%2Fx-callback-url%2Fsuccess&on-failed=some-app%3A%2F%2Fx-callback-url%2Ffailed

带字幕的示例

open-vidhub://x-callback-url/open?url=http%3A%2F%2Flocalhost%3A8080%2Fsample.mp4&sub=http%3A%2F%2Flocalhost%3A8080%2Fsample.srt&on-success=some-app%3A%2F%2Fx-callback-url%2Fsuccess&on-failed=some-app%3A%2F%2Fx-callback-url%2Ffailed

/open 不会在用户退出播放时返回当前播放位置，也无法通过回调区分“播放完成”和“中途退出”。

新版方式：/play

新版调用地址：

open-vidhub://x-callback-url/play

/play 在 iPhone、iPad、Apple TV、Mac、Android Mobile 和 Android TV 上使用相同的地址、参数和回调字段。

它适合将 VidHub 作为外部播放器使用。第三方应用可以传入上次的播放位置，VidHub 退出播放时再通过回调返回最新进度。

一次调用只支持一个视频地址。

请求参数

url、sub 和回调 URL 都必须是包含 Scheme 的完整 URL。回调 URL 不能使用 open-vidhub Scheme，否则会被视为无效回调。

Apple 平台 Swift 调用示例

使用 URLComponents 和 URLQueryItem 生成调用地址，可以避免手动拼接参数时出现编码错误：

func playWithVidHub(
    mediaURL: URL,
    subtitleURL: URL? = nil,
    position: Double = 0,
    filename: String? = nil,
    requestID: String = UUID().uuidString
) {
    var components = URLComponents()
    components.scheme = "open-vidhub"
    components.host = "x-callback-url"
    components.path = "/play"

    var queryItems = [
        URLQueryItem(name: "url", value: mediaURL.absoluteString),
        URLQueryItem(name: "position", value: String(max(0, position))),
        URLQueryItem(name: "request-id", value: requestID),
        URLQueryItem(name: "x-source", value: "My App"),
        URLQueryItem(name: "x-success", value: "myapp://x-callback-url/success"),
        URLQueryItem(name: "x-error", value: "myapp://x-callback-url/error"),
        URLQueryItem(name: "x-cancel", value: "myapp://x-callback-url/cancel")
    ]

    if let filename, !filename.isEmpty {
        queryItems.append(
            URLQueryItem(name: "filename", value: filename)
        )
    }

    if let subtitleURL {
        queryItems.append(
            URLQueryItem(name: "sub", value: subtitleURL.absoluteString)
        )
    }

    components.queryItems = queryItems

    guard let vidHubURL = components.url else {
        return
    }

    #if os(macOS)
    NSWorkspace.shared.open(vidHubURL)
    #else
    UIApplication.shared.open(
        vidHubURL,
        options: [:],
        completionHandler: nil
    )
    #endif
}

Android Mobile / TV Kotlin 调用示例

Android Mobile 和 Android TV 使用相同的 ACTION_VIEW Intent。以下代码可放在两端共用模块中：

import android.app.Activity
import android.content.ActivityNotFoundException
import android.content.Context
import android.content.Intent
import android.net.Uri
import java.util.UUID

fun playWithVidHub(
    context: Context,
    mediaUrl: Uri,
    subtitleUrl: Uri? = null,
    position: Double = 0.0,
    filename: String? = null,
    requestId: String = UUID.randomUUID().toString(),
) {
    val callbackBase = "myapp://x-callback-url"

    val vidHubUri = Uri.Builder()
        .scheme("open-vidhub")
        .authority("x-callback-url")
        .appendPath("play")
        .appendQueryParameter("url", mediaUrl.toString())
        .appendQueryParameter("position", position.coerceAtLeast(0.0).toString())
        .appendQueryParameter("request-id", requestId)
        .appendQueryParameter("x-source", "My App")
        .appendQueryParameter("x-success", "$callbackBase/success")
        .appendQueryParameter("x-error", "$callbackBase/error")
        .appendQueryParameter("x-cancel", "$callbackBase/cancel")
        .apply {
            filename?.takeIf { it.isNotBlank() }?.let {
                appendQueryParameter("filename", it)
            }
            subtitleUrl?.let {
                appendQueryParameter("sub", it.toString())
            }
        }
        .build()

    val intent = Intent(Intent.ACTION_VIEW, vidHubUri).apply {
        if (context !is Activity) {
            addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        }
    }

    try {
        context.startActivity(intent)
    } catch (_: ActivityNotFoundException) {
        // VidHub 未安装，或当前版本尚不支持该调用方式。
    }
}

调用示例：

open-vidhub://x-callback-url/play?url=https%3A%2F%2Fexample.com%2Fvideos%2Fmovie.m3u8&sub=https%3A%2F%2Fexample.com%2Fsubtitles%2Fmovie-zh.srt&position=120&filename=%E7%A4%BA%E4%BE%8B%E5%BD%B1%E7%89%87.mp4&request-id=movie-123&x-source=My%20App&x-success=myapp%3A%2F%2Fx-callback-url%2Fsuccess&x-error=myapp%3A%2F%2Fx-callback-url%2Ferror&x-cancel=myapp%3A%2F%2Fx-callback-url%2Fcancel

实际使用时应由 URLComponents、URLQueryItem 或 Android Uri.Builder 完成百分号编码，不建议手工拼接完整 URL。

回调规则

每次 /play 请求最多触发一次终态回调：

• 正常播放完成或进入播放器后退出：调用 x-success。
• 请求或播放失败：调用 x-error。
• 正式开始播放前取消：调用 x-cancel。

如果调用方没有提供某类回调 URL，VidHub 会直接结束对应流程，不会尝试调用其他类型的回调。

x-success

VidHub 会在视频自然播放完成，或用户在播放过程中退出播放器时调用 x-success。

视频自然播放完成：

myapp://x-callback-url/success?lastPlayedUrl=https%3A%2F%2Fexample.com%2Fvideo.m3u8&position=599&duration=600&status=finished&request-id=movie-123

用户中途退出：

myapp://x-callback-url/success?lastPlayedUrl=https%3A%2F%2Fexample.com%2Fvideo.m3u8&position=38&duration=600&status=stopped&request-id=movie-123

建议调用方根据 status 处理进度：

• finished：将内容标记为已播放，并按自身规则清除或保留续播位置。
• stopped：保存 position，下次调用 /play 时将它传回 VidHub。

x-error

请求参数无效、播放器正忙、无法打开播放器或播放失败时，VidHub 会调用 x-error。

示例：

myapp://x-callback-url/error?errorCode=200&errorMessage=Playback%20failed&failedUrl=https%3A%2F%2Fexample.com%2Fvideo.m3u8&request-id=movie-123

错误码：

x-cancel

x-cancel 只用于正式开始播放前的取消操作。回调不会附带播放进度，只会在请求中包含 request-id 时将其返回：

myapp://x-callback-url/cancel?request-id=movie-123

进入播放器后再退出不属于取消，此时会调用 x-success，并返回 status=stopped。

接收回调

调用方需要注册自己的 URL Scheme。以下示例使用：

myapp://

请将 myapp 替换为你的应用实际注册的 Scheme，并确保 x-success、x-error 和 x-cancel 使用该 Scheme。

Apple 平台

使用 Scene 的 UIKit 应用可以在 SceneDelegate 中接收回调：

func scene(
    _ scene: UIScene,
    openURLContexts URLContexts: Set<UIOpenURLContext>
) {
    guard let url = URLContexts.first?.url else {
        return
    }

    handleVidHubCallback(url)
}

SwiftUI 应用可以使用：

.onOpenURL { url in
    handleVidHubCallback(url)
}

Android Mobile / TV

Android 调用方需要为自己的回调 Activity 注册 Intent Filter：

<activity
    android:name=".VidHubCallbackActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:scheme="myapp"
            android:host="x-callback-url" />
    </intent-filter>
</activity>

然后从 intent.data 读取回调路径和查询参数：

val callbackUri = intent?.data ?: return

when (callbackUri.path) {
    "/success" -> {
        val position = callbackUri.getQueryParameter("position")?.toDoubleOrNull()
        val duration = callbackUri.getQueryParameter("duration")?.toDoubleOrNull()
        val status = callbackUri.getQueryParameter("status")
        val requestId = callbackUri.getQueryParameter("request-id")
    }

    "/error" -> {
        val errorCode = callbackUri.getQueryParameter("errorCode")
        val errorMessage = callbackUri.getQueryParameter("errorMessage")
    }

    "/cancel" -> {
        val requestId = callbackUri.getQueryParameter("request-id")
    }
}

Android TV 通常没有网页浏览器，因此 TV 端建议使用调用方应用自己注册的回调 Scheme，而不是依赖 HTTPS 网页回调。

URL 编码注意事项

新版 /play 应把原始参数传给系统 URL 构造工具，由系统统一完成百分号编码：

URLQueryItem(name: "url", value: mediaURL.absoluteString)

uriBuilder.appendQueryParameter("url", mediaUrl.toString())

不要先手动编码，再交给 URLQueryItem 或 Uri.Builder，否则可能发生二次编码。

旧版 /open 继续保留原有编码方式，以兼容已有 Apple 平台接入。

从 /open 迁移到 /play

已有 Apple 平台接入可以按以下步骤迁移：

1. 将路径从 /open 改为 /play。
2. 将 on-success 改为 x-success。
3. 将 on-failed 改为 x-error。
4. 根据需要增加 x-cancel 和 request-id。
5. 将本地保存的播放进度通过 position 传给 VidHub。
6. 在回调中读取 position、duration 和 status。
7. 新接口使用系统 URL 构造工具统一编码。

Android Mobile 和 Android TV 应直接使用 /play，无需兼容 /open。

使用注意事项

• 每次调用只支持一个视频 URL。
• /play 在 iPhone、iPad、Apple TV、Mac、Android Mobile 和 Android TV 上使用相同的协议字段。
• 视频和字幕地址必须能从运行 VidHub 的设备访问。
• 视频地址可以使用 VidHub 支持的网络或本地 URL Scheme，但不能使用 open-vidhub 作为媒体地址的 Scheme。
• 回调 URL 必须属于第三方应用自身注册的 Scheme，不能使用 open-vidhub。
• 如果第三方应用未安装，或没有应用能处理回调 Scheme，VidHub 不会持续重试。
• 应用被强制结束、系统关机或进程异常退出时，无法保证一定发送最终回调。
• 这套回调用于第三方应用与 VidHub 之间同步本次播放进度，不依赖 Trakt 登录或 Trakt Scrobbling。

目前的vidhub是苹果多端都可以享受同一个vip，也就是说ios/ipad/mac/tvos。都可以通过恢复购买恢复你的VIP状态。

如果有多账号，请将其他账号登出，建议再重启一次设备，然后再点击恢复购买。

国区账号能在Apple tv上恢复购买吗？

是可以的，由于Apple tv上没有国区的app store，所以需要更改一下操作。

具体操作：如果是国区账号购买的，首先在apple tv上用外区账号登录然后下载vidhub，再到设置里，切换国区账号，这时候app store会消失，但是没关系，到vidhub里点恢复购买。具体恢复购买的操作可以如上所示。

iPad/iOS/Mac 如何恢复购买？

这就非常简单啦，如果在国区购买的软件，那就在国区下载软件，点击恢复购买。

如果是外区购买的软件，那就在外区下载软件，点击恢复购买。

如果上述行为都不行，可以卸载重装，再次使用购买的apple id再次恢复购买。如果这样还不行，可以再次购买同样的订阅，同一个apple id 的同一笔订阅项目不会重复扣费哦！

目前的解决方案是在电视里找到运动补偿然后关掉就可以了，如果还是不行，请联系管理员

从苹果的应用商店，iTunes商店，Apple Books书店或者其他任何Apple苹果服务购买的项目，只要符合退款条件的，你可以随时退款。
先从效率最高说起吧。
人工客服退款
苹果客服热线：400 666 8800，就是这么简单，虽然有很多在线退款的方式，但是我建议不熟悉的可以直接拨打电话省事多了，语音提示选择：1-普通话服务 - App Store账单问题 - 联系人工客服，注意虽然联系人工客服退款效果更好，速度更快，但是一定要在回答的时候说明是自己误操作或者对扣款不知情，不然同样很难退款成功。

最简单的网页退款方式

打开这里 reportaproblem.apple.com。
根据提示登录你的苹果账号。（一定要用当初购买app的同一个苹果账号）
登录成功后，进入报告问题的页面，这里有你的每一笔App Store的购买记录，包括免费的应用，付费的应用，内购的应用，甚至你订阅的内容服务，比如音乐，电影，电子书等，
点击报告，然后选择一个问题，选择 "我想申请退款"，这里划重点了，退款理由一定要写，如果不写，或者写的不够充分，是不会被审批通过的。常用的理由，或者说容易通过的理由：
误操作购买，并不需要这款应用
应用没有想要的功能，申请退款
应用忽然降价，申请退款重新购买
被莫名其妙扣款，请及时退款
并不需要订阅，应用没有即时提醒取消有了这些理由基本就没问题了，可以耐心等待退款即可。当然退款一般需要一天到48小时，无论是否被苹果批准退款，都会收到通知。

不过上面的操作，是否被批准，还是取决于苹果，有时候也会有退款被拒绝的情况，比如之前有过多次的退款的经历，或者同一时间退款多个订单，这些都是有可能导致退款申请被拒绝的。不过不用担心我们可以采用最后一招。

最后一招，在上面的选择问题的时候，直接选择我没有授权此项购买，不过这个选项涉及到安全问题，需要联系客服来处理，所以直接选者iTunes Store支持，进入Apple技术支持的页面，就可以跟苹果客服进行通话。可以告诉苹果这个购买可能是家里小孩或者其他人不知情的情况下购买的。这招如果都不能退款，可能就放弃吧。

在苹果iPhone手机或者iPad平板电脑上退款

苹果默认没有内嵌到前面的网页的地方，为什么苹果购买的时候那么的方便，到了退款就这么的麻烦。不过不用担心，只要找到购买记录就好了，按照这个思路，只要找到账号相关的信息就好了，有两种方法。

第一种方法，跟前面的找到哪个报告问题的链接一样，你的每次购买记录都会有对应的邮件，苹果都会发送对应的购买记录到您的邮箱，其实在哪个邮箱里面就有一个 “报告问题” 的链接，点击后跟前面的在网页上退款一样的步骤。

如果你没有找到邮件怎么办, 没关系打开你的iPhone/iPad 找到 "设置" -> "Apple ID, iCloud, 媒体与购买项目" -> "媒体与购买项目" -> "查看账号", 然后在最下面你就能看到你的购买记录和所有的订阅内容了.

一旦找到这里，找到购买记录后面的事情就好办了，点开你想要退款的记录，找到报告问题，就可以按照之前的方法去申请退款。尤其是退款理由一定要写清楚。

在你的苹果Mac电脑上退款

跟你在手机上一样，找到你的购买记录，打开Mac AppStore商店，点你的账号右上角 "查看信息" -> "管理"，你就能找到你的所有的购买记录了，过程中可能需要你登录账号输入密码，但是重要的是你又找到了所有的购买记录和订阅服务，剩下的就重要的退款理由一定要写清楚奥。

正常情况下你在两天内就能收到苹果的回复，审核员可能会批准，也可能不会批准。但是不要同时申请多次退款，或者在你的付款还未完成之前就申请退款，退款一定要在付款状态是完成的时候才能申请。
不过你总是可以在苹果的官网找到详细的退款步骤，这里是苹果的官方帮助文档，如果苹果后面改了任何东西，都可以参考苹果的文档。

iCloud 可在多台设备之间同步信息，如文件源，媒体库，观看记录，播放列表，收藏夹，媒体服务器等。

• 在所有设备上登录相同的 iCloud ID
• 在所有设备上启用 iCloud 云盘
• 在 VidHub > 设置 > 同步 > iCloud同步
• 确保 iCloud 有同步所需要的存储空间
• 在所有设备上运行最新版本的 iCloud
• (注：若iCloud储存空间不够或者已满，可能会导致导入文件丢失或错误无法播放视频)

隐藏剧透：打开隐藏剧透时剧集详情页面不展示剧集简介。关闭隐藏剧透，展示剧集简介。
媒体排序方式：设置浏览媒体的默认排序方式
文件排序方式：设置浏览文件的默认排序方式
外观：更换黑色或者白色UI，或者跟随系统自动
在线影视数据语音：更换在线影视数据语言，也可以跟随系统系统语言自动识别
允许使用蜂窝：打开 - 下载时允许使用。关闭 - 下载时不允许使用
并发数：同时下载影片数量
显示悬浮窗：下载时显示一个小浮窗，打开则显示，关闭则隐藏
播放时暂停：打开 - 在播放时会自动暂停下载。关闭 - 在播放时不暂停下载

资源

媒体库：显示当前所拥有的影片类型数量
重新扫描文件：重新扫描所有文件源下的视频文件，找出变动的文件并同步到媒体库中
刷新在线影视数据：从TMDB网站重新获取电影电视剧的信息，如果在设置里修改了在线影视数据的语言，则执行该操作后，才能根据新的语言重新获取电影电视剧的信息。
文件源：点击对勾则启用文件源，取消对勾则禁用文件源

下载

可查看储存下载到本地的影片，可进行删除

同步

iCloud 同步- 允许通过 iCloud 同步媒体库详细信息

播放

快进间隔/快退间隔：每次快进或快退的时间设置
打开阿里/百度网盘视频时：可选择播放原画或者播放最高分辨率视频流
连续播放：打开、自动播放下一集。关闭则不自动播放
后台播放：打开、退到后台，视频继续播放。关闭则不会继续播放
始终记住播放速度：退出前设置的播放倍数，在下次还是同样的播放倍数
硬件加速：优化硬件速度
缓存到磁盘：开启或禁用缓存磁盘

播放器界面

自动隐藏播放控制面板：自动隐藏播放控制面板的时间设置
进度条右侧时间：视频总时长或视频剩余时长
长按倍速播放：选择倍速播放速度
双击屏幕两次快进/快退：打开或关闭
显示截图/录屏按钮：打开或关闭
默认横向显示：打开或关闭横向显示影片
播放控制面板背景阴影：打开或关闭背景阴影

字幕

自动加载外挂字字幕规则：切换自动加载字幕文件的规则
自动加载内置字幕：打开或关闭自动加载
自动加载内置字幕语言：语言选择设置（前提为内置支持所改字幕/语言）
在线字幕搜索语言：语言选择设置（前提为内置支持所改字幕/语言）

截图和录屏

图片格式：选择截图的图片格式
Gif帧率：帧率选择设置
Gif分辨率：分辨率选择设置

1、单指双击：双击画面左侧快退，双击画面右侧快进，双击画面中间暂停/继续。
2、单指滑动：按住画面左侧上下滑动调节亮度，按住画面右侧上下滑动调节音量。
3、双指捏合：双指按住画面进行捏合操作可以缩小画面，反正则可以放大画面。

播放器左侧操作界面

1、屏幕锁定：左边锁一样图标的按钮就是锁定屏幕的按钮，当按钮成白色打开状时，则可以对当前界面进行操作。若为绿色闭合状态时，则不可对当前界面进行“任何操作”，只可再次点击锁按钮解锁。
注：点击锁定的时候，所有的其他icon都会隐藏，再次点击则会显示。
2、视频旋转：绿色状态为当前横屏。若点击成白色后，则称为竖屏。
3、选集：左下方三道横杠的图标在点击后会出现在“同一文件夹内”所有的影片文件。若文件夹内只有一个影片文件，这个按钮则不会显示。
4、分辨率：下方原画是设置分辨率的按钮，点击后会展开可选择的分辨率。
注：若视频为WebDAV/Alist导入，则不会展示分辨率。在文件夹内只有一个文件且是WebDAV/Alist导入，则选集和分辨率都不会展示。

播放器右侧侧操作界面

1、截图：右侧中间图片样式图标为截图，点击后会截取当前画面帧。（暂停/播放都可使用
2、GIF：在点击Gif时会开始录制GIF图，再次点击会自动生成GIF图，生成的GIF会保存至相册，再次点击屏幕任何空白位置则可关闭GIF小录制窗。（如果视频暂停的时候使用GIF，视频会自动开始播放）
3、铺满屏幕：点击后会自适应铺满屏幕
4、字幕：可选择字幕展示渠道
5、播放倍速：点击可选择视频播放倍速
6、镜像投屏：点击上方电脑样式icon可将手机画面投屏到Apple TV

右上角更多操作（三个点）

1、点击更多后会展示视频的设置（如果对均衡器不熟悉，尽可能的不去动色彩均衡器的数值，可能会导致颜色偏差）

2、音轨则是声音播放的方式与数值，如果禁用会导致没有声音。（如果对均衡器不熟悉，尽可能的不去动音频均衡器的数值，可能会导致音频偏差）

3、在字幕设置中，如果视频自带字幕，则可以将主字幕禁用。如果您需要加载本地自己的字幕点击按钮选择加载本地字幕即可（字幕与视频文件需要在同一文件夹切命名一致）
3.1、下滑有一个编码，如果在使用本地字幕的时候出现了乱码情况，点击编码，选择加载本地字幕的语音，然后快进一下即可。

影片刮削错误或者刮削失败被归类为其他时，使用此功能将对应的文件改为正确的电影/电视剧

功能入口

单部电影和在其他分类中的视频

在媒体库长按（桌面端为右击）视频海报，然后选择 “编辑信息” 选项。或者进入影片详情页点击右上角三个点，点击编辑信息

电影合集/电视剧

进入影片详情页，选择单集，点击右上角三个点，点击编辑信息

功能使用介绍

1、输入框：编辑信息界面输入框可以输入影片名称搜索，在搜索结果中选择对应影片，被编辑的影片信息将会被替换成所选的影片
2、修改为电影：在其他类目中的影片，搜索到正确的电影信息后应用，该影片将会被移动至电影类目
3、修改为电视剧 ：在其他类目中的影片，搜索到正确的电视剧信息后应用，该影片将会被移动至电视剧类目
4、使用原文件数据：在电影/电视剧类目中的影片，选择使用原文件数据后，该影片将会被移动至其他类目


5、修改电视剧：如果要改一部电视剧，先进入影片详情页，选择某一季任意一集，点击右上角三个点，后点击编辑信息，搜索到想要修改的电视剧后并更改。等待片刻，该剧所有集的信息将会全部被自动修改。

进入文件源后，长按文件源内单个文件夹/文件后点击重命名，会弹出重命名的弹窗，填入新命名后，点击保存后，被重命名的文件夹/文件则会使用新的命名

多选批量修改

进入文件源后，点击文件源内的右上角三个点，再点编辑，在点击右下角三个点，就可以多选文件/文件夹进行重命名

当前步骤可以对前一步选择的文件夹/文件进行批量重命名

添加文本：

是指在原始文件名的基础上添加新的文本的改名方式
如果选择在名字之前，输入的内容则会显示在原始命名之前
如果选择在名字之后，输入的内容则会显示在原始命名之后
例如：在名字之前添加"123"，重命名后所有文件名称前面都会加入"123"

替换文本：

是指将原始文件名中的某些文本替换为新的文本的改名方式
在"查询"输入框内输入需要被替换的文字A，在"替换为"输入框内输入替换后的文字B，文件名中的文字A将被全部替换为文字B
例如查询框内输入"Doctor"，替换为输入框内输入"123"，重命名后所有文件名中的"Doctor" 就会被更换为"123"

格式化

是指给原始文件名统一加上数字索引的改名方式
自定义格式：是对文件名的重新设置
开始索引：索引的数字可以理解为电视剧的季数或者集数
在名字之后/之前：索引的数字是加在自定义格式之前还是之后，重命名后文件名会变成"{自定义格式}{索引数字}"或者"{索引数字}{自定义格式}""
例如： 自定义格式设置为 "测试"，如果选择在名字之后，则重命名为"测试01"。如果在之前则是"01测试"。
固定长度：索引数字显示的位数
例如：对于索引数字"1", 如果固定长度是1，则显示"1"。如果固定长度是2，则显示"01", 如果固定长度是3，则显示"001"
如下图所示，自定义格式设置为"速度与激情S01E"，且索引在名字之后，则选中的所有文件将被重命名为 "速度与激情S01E{索引数字}"，因为开始索引数字设置为"5"，且长度为2位 ("5"显示为"05")。所以最终两个文件会被重命名为"速度与激情S01E05","速度与激情S01E06"

正则表达式

高级替换功能，是指使用正则表达式将某些文本替换为新的文本的改名方式
在正则表达式框里面输入你想要替换的内容，例如"\d{3}"，该正则表达式代表任意的三位数字，在替换为输入框里面输入替换后的文字B，原文件中任意的三位数字将会被替换为文字B
注：正则表达式的使用方法请自行搜索

当自动匹配的电影和剧集错误时，你可以通过修改文件名，或者手动编辑信息来修改为正确的影视信息。
1、修改文件名
2、手动编辑信息

电影的正确命名

文件的名称以影片的完整名字开头（中英文均可），例如：
1、流浪地球.1080p.x264.mp4
2、Ghosted.1080p.x264.mp4
3、Ghosted.神出鬼没.1080p.x264.mp4

如果有同名影片，务必在文件名中带上电影发行日期，例如：
1、流浪地球.2019.1080p.x264.mp4

电视剧（包括综艺,动画）的正确命名

同一部电视剧里的每一集都要以剧名开头（中英文均可）后面必须写上季和集的信息，举例：S01=第一季 S02=第二季。E01=第一集，E02=第二集 例如：
1、琅琊榜.S01E01.1080p.AMZN.WEB.DL.mkv
释义：琅琊榜 第一季 第一集

2、Shameless.S03E02.1080p.AMZN.WEB.DL.mkv
释义：Shameless 第三季 第二集

如果有同名电视剧，务必在文件名中带上电视剧首次发行日期，例如：
3、Shameless.无耻之徒.2011.S02E02.1080p.AMZN.WEB.DL.mkv

电视剧花絮、特别篇

电视剧花絮、特别篇文件名以剧名开头，后面的季数信息为必填，填00即可，并指定集数。例如：
1、琅琊榜.S00E01.SneakPeek.1080p.AMZN.mkv
释义：琅琊榜 特别篇 第一集

下文中所有的长按操作均为移动端版本，对应桌面端版本为鼠标右击操作。

单文件操作

重新扫描文件（文件源/文件夹）

长按已添加的文件源或者进入已添加的文件源后长按文件夹，可以重新扫描该文件源/文件夹下面的所有视频文件，并自动将新增/删除/重命名的视频文件同步到媒体库。也可以进入文件夹A后，点击右上角三个点，再点击弹出菜单里面的重新扫描文件。

重命名

在VidHub内，对文件源里的文件/文件夹改名后，改名的文件/文件夹的原始文件名都会被直接更改。媒体库中的影片信息会根据新文件名重新刮削。查看视频文件命名规则

下载（文件）

长按文件，会弹出选框，点击下载则可以把影片下载到本地文件。可以在设置-下载中查看下载文件。

删除

在VidHub内，对文件源里的文件/文件夹删除后，对应存储中的原始文件会被直接删除。媒体库中对应的影片信息也会被移除。（删除需谨慎）

放入回收站（阿里云盘）

在阿里云盘的文件源里的文件进行长按可把文件夹/文件放入回收站，放入回收站的文件，可在阿里云盘的回收站里看到，可以在阿里云盘里进行恢复。

多文件操作

1、在进入文件源页面时，选一个文件夹进入后可以看到所有的影视文件，点击右上角三个点再点编辑
在这里点击重新扫描文件（当前目录）也可以进行文件扫描

2、点击编辑后所有页面将进入可编辑状态

3、选取一个或者多个文件后点击右下角的三个点就可以对选取文件进行操作，操作结束后点击右上角完成即可

1、观看影片时，未观看完的影片会进入继续观看类目并显示观看进度，直接点击白色播放按钮即可继续观看
2、如果是电影，看完后则会进入已观看类目
3、如果是电视剧，看完当前一集则会在继续观看里展示下一集。当存在多季时，看完一季后会展示下一季的第一集，所有季都看完后会进入已观看类目。

4、在继续观看类目里长按视频可“标记为已观看“

5、出现三个课标记为观看的选项
5.1、当前剧集：如果选择当前剧集，这集影片会被加入已观看类目。
5.2、整季剧集：如果选择整季剧集，影片一季内的所有影片会被加入已观看类目。
例如：第一季被加入，第二季会展示在继续观看。
5.3、整部剧集：如果选择整部剧集，则该影片全部会被加入已观看类目。
例如：所有季和集都会被加入已观看，继续观看不展示。

新增播放列表

1、如果想建立自己的播放列表，在首页点击右上角三个点后，点击编辑媒体库
2、在最底下找到播放列表并打勾（默认是不展示的）

3、在媒体库找到播放列表点击查看全部

4、全部播放列表页面，点击右上角新建播放列表

5、对新建播放列表进行命名后点击保存
6、保存后新增的就会展示在播放里表页面里

删除播放列表

1、如果想要删除一个播放列表，需进入想要删除的列表里后点右上角三个点，然后点击删除播放列表
注：删除播放列表仅删除播放列表，影片在媒体库还可以看到。

影片加入播放列表

如果想把影片加入播放列表，在媒体库页面长按电影海报后，点击添加到播放列表即可
注：如果是剧集添加到播放列表，则会把剧集内所有的影片全部加入列表

添加到收藏夹

长按影片海报，点击添加到收藏夹，则该影片也会显示在收藏夹类目里。再次长按点击从收藏夹中移除则可以移出收藏夹
注：收藏夹类目需在选中展示时才会看到，否责不展示。（可在媒体库-右上角三个点-编辑媒体库种进行设置）

标记为已观看

标记为已观看的影片将会进入该类目，取消则移出
注：如果影片在继续观看类目里被标记了已观看，即使取消已观看，之前的观看记录不会存在。

媒体库状态信息

扫描文件时，拉到底部可以查看当前扫描状态。扫描完成后，底部会展示媒体库中所有电影/电视剧/其他视频的数量。

媒体库

媒体库：展示的所有影片全部来自于“文件源”里的视频文件，当你添加了新的文件夹作为文件源后，会自动搜索刮削该文件源下的所有视频文件并添加到媒体库中。
释义：刮削=根据视频文件的文件名，在线搜索电影剧集信息和海报，把搜索到的影片添加到媒体库并整理好后展示出来。
1、点击右上角三个点会弹出“重新扫描文件”“编辑媒体库”。
1.2：“重新扫描文件”顾名思义，重新扫描所有文件源下的视频文件，找出变动的文件并同步到媒体库中。当文件源下面的视频文件发生变动时(新增/删除/重命名)，需要重新扫描文件来同步媒体库。
（文件源中影片过多的小伙伴慎重使用，因为会全量扫描所有文件源，可能耗时很长。如果明确知道自己新添加/删除/重命名的视频文件的位置，建议单独扫描该位置，这个后边会讲到）
1.3：“编辑媒体库”就是对媒体库里面的类目进行“展示/隐藏/排序”，例如隐藏电影类目，就看不到了。列表的排序，例如把电视剧调到第2个位置，电影调到第1个位置。
1.4：点击查看全部只查看当前这个类目的全部影片。

文件源

文件源：可以理解为一个仓库，是一个管理影片资源的地方，支持添加，删除，禁用，重命名，以及重新扫描文件
释义：就是存放影片的仓库
1：长按已经添加的任意文件源
1.2：删除：删除该文件源，删除后媒体库中所有相关的影片也会被自动移除。
1.3：禁用/启用：点击禁用，媒体库所有相关的影片会隐藏，点击启用，媒体库所有相关的影片会重新显示
1.4：重命名：顾名思义，修改“文件源”的名称。
1.5：重新扫描文件：单独对这个文件源下面的文件进行扫描。不会影响到其他文件源

1.6：文件源左上角的是命名规范，按照规范给电影/剧集进行命名，VidHub才会自动扫描到相应的电影/剧集信息，并归纳到媒体库中。
1.7：编辑：点击右上角三个点，点击编辑后可以多选文件源并进行删除
1.8：添加/修改文件源：点击右上角三个点，会出现“添加/修改文件源”

1.9：点击“添加/修改文件源“进入当前页面（这里存储着已添加的本地/网络/网盘）
2.0：点击添加存储跳转
2.1：网络共享：需要输入“服务器地址”（网址）、端口号、用户名、密码、路径（选填）（来自于网友分享，或者有自己存储的网址视频，前提VidHub支持，目前支持WebDav和SMB协议）
2.2：云盘：将云盘里的影片导入到VidHub进行整理、播放，具体请看新手入门，目前支持阿里云盘/百度网盘/Dropbox/OneDrive/GoogleDrive/Premiumize等；

2.3：打开本地视频：点击后会弹出iCloud云盘，如果资源在iCloud，则可以直接点击进入对应文件夹，后点影片则可以直接播放。
如果不在则点击左上角返回到浏览，在位置类目里找到“我的iPhone”点击，在我的iPhone的文件里找到存放影片资源的文件夹并点击进入，后点视频文件则可以直接播放。
注：打开本地视频会直接播放选中的视频文件
2.4：添加本地目录：选择一个本地的文件夹作为文件源。 点击后会弹出iCloud云盘，如果资源在iCloud，则可以直接点击进入对应文件夹，后点右上角“打开”则可将该目录添加为文件源。
如果不在则点击左上角返回到浏览，在位置类目里找到“我的iPhone”点击，在我的iPhone的文件里找到存放影片资源的文件夹并点击进入，后点右上角“打开”则可将该目录添加为文件源。
注：选择的本地目录会被添加到文件源中，并将该目录下所有的视频文件刮削整理后导入到媒体库中
如果你的本地影片在相册，你需要到相册长按你的影片然后点击共享-存储到“文件”，之后再通过VidHub打开本地视频/本地目录功能播放或导入到媒体库

影视服务器

影视服务器：VidHub支持添加Plex/Emby/Jellyfin影视服务器。通过输入服务器地址，用户名，密码等信息就可以登录并添加一个影视服务器，添加成功后，点击进入这个服务器进行观影。（影视服务器可以自建也可以寻找他人搭建的公益服）

第一步：初次进入VidHub App后可以看到“媒体库”的添加按钮，点击“添加”按钮；

第二步：点击“添加”按钮后在点击添加存储会跳转到添加存储页面，这里拿阿里云盘做示范。

第三步：点击添加阿里云盘会跳转到添加阿里云盘页面，然后直接点击添加
第四步：点击添加后跳转到VidHub申请云盘页面，然后点允许。（如果没有登录阿里云盘会先进行登录
注：（备份盘和资源库是阿里云盘存放文件的位置，建议都勾选）
第五步：会弹出弹窗，随后点击打开
第六步：出现这个页面，就可以选择影片所在的文件夹作为文件源。点击文件夹后面的选择框，出现对勾则是选中，然后进行文件源命名后点击完成即可。完成后VidHub会自动查找该文件夹下面的所有影片并导入媒体库中。
例如，备份盘里有一个文件夹A，文件夹A里还有一个文件夹B，用户所有的影片都在文件夹B下。这时候用户可以进入备份盘，再进入A，单独勾选B作为文件源，文件夹B下的所有影片将被自动导入媒体库。
注：只可选择“文件夹”作为文件源并自动导入媒体库，“文件”是不可单独选择导入的🙅

第七步：当点击完成后会自动回到添加/修改文件源页面，再次点击左上角返回图标后就会返回到文件源列表页面
第八步：随后点击媒体库，VidHub会自动为你查找刚刚添加的文件源下面的所有影片文件，根据影片文件名自动获取在线电影/剧集信息和海报并添加到媒体库中，你的影片资源将会展示在这里。点击即可观看。（影片文件名的命名规则）

VidHub是一款适用于 iPhone、iPad、Apple TV 和 Mac 的多功能视频播放器。当您需要一个功能完备的媒体播放器来管理、组织和播放各种类型的视频时，VidHub会满足您的需求。
VidHub支持管理阿里云盘/百度网盘/Google Drive/Dropbox/One Drive上的视频文件，支持samba(smb) / webdav协议，支持群晖等NAS网络存储，支持本地文件，支持Plex/Emby/Jellyfin媒体服务器。
VidHub能自动根据视频文件名刮削获取电影/剧集封面等信息，自动分类整理您的影视资源，支持一键全局搜索。同时拥有强大易用的播放功能，支持倍速，字幕，截图，HDR，杜比视界等。

支持哪些媒体格式

VidHub能够支持广泛的视频播文件
视频：mkv、mp4、.mov、.rmvb、avi、webm、wmv 等等
字幕：VidHub 支持视频内置字幕，并可以挂载多种外置字幕格式，例如 SRT, SSA, ASS,SUB

VidHub的最佳兼容设备

Mac
设备需装有macOs 10.15 或更高版本。
iPhone
设备需装有 i0S 14.1 或更高版本。
iPad
设备需装有 iPados 14.1 或更高版本。
iPod touch
设备需装有 ios 14.1 或更高版本。
Apple Vision
设备需装有 visionOs 1.0 或更高版本。
Apple TV
设备需装有 Apple tvOS 14.0 或更高版本。

VidHub还可以为我做些什么？

VidHub拥有优秀的文件管理功能，并支持界面展示视频的清单。用户可以按照类型、日期、分级、评分等分类，快速找到需要的媒体文件。
不止于此，VidHub还有很多强大的功能等着您来发现。我们还在不断为用户体验砥砺前行，若您有宝贵的建议与意见，非常欢迎您在社区或AppStore以及邮箱向我们反馈，谢谢。