BitComet(比特彗星)高效好用的BT下载软件，BT资源的下载利器

本页面只读。您可以查看源文件，但不能更改它。如果您觉得这是系统错误，请联系管理员。
=== WebUI 调用本地视频播放器 ====

本页面详细介绍 WebUI 调用本地视频播放器的功能说明、使用方法及注意事项，为用户提供完整的操作指引。

=== 1. 功能概述 ===

WebUI 支持通过**自定义协议**（如 %%vlc://、potplayer://%%）唤起用户设备上已安装的本地视频播放器（如 VLC、PotPlayer），直接播放下载任务中指定视频文件的HTTP链接。该功能可规避浏览器播放组件的格式限制，充分利用本地播放器的高级功能。

=== 2. 核心优势 ===

- **格式兼容性强**：支持播放浏览器原生不支持的特殊格式视频（如 MKV、FLV 高清格式）。

- **功能更丰富**：可调用本地播放器的高级解码、多音轨切换、字幕调节、倍速播放等专属功能。

- **性能提升**：本地播放器可调用硬件加速功能，提升大码率视频的播放流畅度。

=== 3. 前置条件 ===

以下条件需全部满足，否则无法正常唤起本地播放器。
    
- 本地设备已安装**支持的视频播放器**（官方推荐：[[https://www.videolan.org/|VLC 媒体播放器]]、[[https://potplayer.daum.net/|PotPlayer]]）。

- 播放器已完成**自定义协议注册**（如 %%vlc://%% 协议需关联 VLC 播放器）。注册方法参考下一节。

- 浏览器未拦截自定义协议调用（首次使用时，浏览器可能弹出提示，需选择“允许”或“始终允许”）。

=== 4. 附录：协议注册方法 ===

== 4.1 VLC 播放器协议注册 ==

正常安装VLC播放器后，还需使用以下批处理文件注册自定义协议：

<file bat vlc_reg.bat>
@echo off
setlocal enabledelayedexpansion

:: Check if the script is running with Administrator privileges
fltmc >nul 2>&1 || (
    echo ERROR: This script requires Administrator privileges!
    echo Please right-click and select "Run as administrator".
    pause
    exit /b 1
)

:: Find VLC installation directory
for /f "tokens=1,2* delims=:" %%a in (
  'reg query "HKLM\SOFTWARE\VideoLAN\VLC" /v "" 2^>nul ^| findstr "(Default)"'
) do (
  for /f "tokens=1,2,3" %%l in ("%%a") do (
    set "player_disk=%%n"
  )
  set "player_exe=!player_disk!:%%b"
)

:: Verify vlc.exe exists
if not exist "!player_exe!" (
  echo VLC executable not found: !player_exe!
  pause
  exit /b 1
) else (
  echo Found VLC executable path: !player_exe!
)

:: Start registering registry entries

:: Create vlc root key with default value
reg add "HKCR\vlc" /ve /t REG_SZ /d "URL:VLC Protocol" /f >nul

:: Create URL Protocol entry (empty value)
reg add "HKCR\vlc" /v "URL Protocol" /t REG_SZ /d "" /f >nul

:: Create shell\open\command entry with properly quoted executable path
:: powershell -Command "$url = '%1' -replace '^vlc://(http|https)//', '$1://' ; & \"C:\Program Files\VideoLAN\VLC\vlc.exe\" \"$url\""
reg add "HKCR\vlc\shell\open\command" /ve /t REG_SZ /d "powershell -Command \"$url = '%%1' -replace '^vlc://(http^|https)//', '$1://' ; ^& \\\"!player_exe!\\\" \\\"$url\\\"\"" /f >nul

:: Verify registration result
if %errorlevel% equ 0 (
  echo VLC protocol registered successfully!
) else (
  echo Failed to write to registry. Please run this script as Administrator.
  pause
  exit /b 1
)

endlocal
pause
</file>

将此bat文件保存到本地后，右键单击“以管理员权限运行”，即可注册vlc自定义协议。

== 7.2 PotPlayer 播放器协议注册 ==

正常安装PotPlayer播放器(64位版)后，默认已配置potplayer自定义协议。如果自定义协议失效，可使用以下批处理文件进行修复：

<file bat potplayer_reg.bat>
@echo off
setlocal enabledelayedexpansion

:: Check if the script is running with Administrator privileges
fltmc >nul 2>&1 || (
    echo ERROR: This script requires Administrator privileges!
    echo Please right-click and select "Run as administrator".
    pause
    exit /b 1
)

:: Find PotPlayer installation directory
for /f "tokens=1,2* delims=:" %%a in (
  'reg query "HKLM\SOFTWARE\DAUM\PotPlayer64" /v "ProgramPath" 2^>nul ^| findstr "ProgramPath"'
) do (
  for /f "tokens=1,2,3" %%l in ("%%a") do (
    set "player_disk=%%n"
  )
  set "player_exe=!player_disk!:%%b"
)

:: Verify PotPlayerMini64.exe exists
if not exist "!player_exe!" (
  echo PotPlayer executable not found: !player_exe!
  pause
  exit /b 1
) else (
  echo Found PotPlayer executable path: !player_exe!
)

:: Start registering registry entries

:: Create potplayer root key with default value
reg add "HKCR\potplayer" /ve /t REG_SZ /d "URL:PotPlayer Protocol" /f >nul

:: Create URL Protocol entry (empty value)
reg add "HKCR\potplayer" /v "URL Protocol" /t REG_SZ /d "" /f >nul

:: Create shell\open\command entry with properly quoted executable path
reg add "HKCR\potplayer\shell\open\command" /ve /t REG_SZ /d "\"!player_exe!\" \"%%1\"" /f >nul

:: Verify registration result
if %errorlevel% equ 0 (
  echo PotPlayer protocol registered successfully!
) else (
  echo Failed to write to registry. Please run this script as Administrator.
  pause
  exit /b 1
)

endlocal
pause
</file>

将此bat文件保存到本地后，右键单击“以管理员权限运行”，即可注册potplayer自定义协议。