htmlplayer 0.3.1

一个简单的HTML视频播放器，使用Edge浏览器或系统默认浏览器播放视频

HTMLPlayer

一个简单的Python库，用于使用Microsoft Edge浏览器或系统默认浏览器播放HTML5视频。

安装

pip install htmlplayer

快速开始

基础用法

from htmlplayer import play_video

play_video('https://example.com/video.mp4')

指定窗口大小

play_video('https://example.com/video.mp4', width=1280, height=720)

仅使用Edge浏览器

from htmlplayer import play_with_edge

play_with_edge('https://example.com/video.mp4')

使用系统默认浏览器

from htmlplayer import play_with_browser

play_with_browser('https://example.com/video.mp4')

API 文档

play_video(url, width=None, height=None, use_edge=True, use_browser_fallback=True)

使用Edge浏览器或系统默认浏览器播放视频。

参数:

• url (str): 视频URL地址
• width (int, optional): 窗口宽度
• height (int, optional): 窗口高度
• use_edge (bool): 是否优先使用Edge浏览器，默认True
• use_browser_fallback (bool): Edge不可用时是否使用默认浏览器，默认True

返回:

• bool: 播放是否成功启动

play_with_edge(url, width=None, height=None)

仅使用Edge浏览器播放视频。

play_with_browser(url, width=None, height=None)

使用系统默认浏览器播放视频。

find_edge_browser()

查找Microsoft Edge浏览器的安装路径。

返回:

• str or None: Edge浏览器的安装路径，若未找到返回None

calculate_window_size(width=None, height=None, scale=None)

根据视频宽高计算合适的窗口大小（严格等比缩放）。

参数:

• width (int/float, optional): 视频宽度（像素），不传则使用屏幕宽度
• height (int/float, optional): 视频高度（像素），不传则使用屏幕高度
• scale (float, optional): 自定义缩放比例（相对屏幕），默认None表示自动计算

返回:

• tuple: 包含窗口宽度和高度的元组 (final_width, final_height)

自动缩放规则:

• 横屏视频（宽 >= 高）：缩放到屏幕的 50%
• 竖屏视频（宽 < 高）：缩放到屏幕的 80%
• 严格保持原视频纵横比

系统要求

• 操作系统：Windows
• Python 3.8+
• Microsoft Edge浏览器（可选，推荐）

示例代码

安装后，你可以查看 examples/ 目录下的示例代码：

# 简单示例
python -c "import htmlplayer.examples.simple_example"

# 或找到安装位置查看文件
python -c "import htmlplayer; import os; print(os.path.join(os.path.dirname(htmlplayer.__file__), '..', 'examples'))"

示例文件：

• simple_example.py - 基础使用示例
• advanced_example.py - 高级功能和自定义配置

许可证

MIT License