Metadata-Version: 2.4
Name: htmlplayer
Version: 0.3.1
Summary: 一个简单的HTML视频播放器，使用Edge浏览器或系统默认浏览器播放视频
Home-page: https://github.com/yourusername/htmlplayer
Author: lenvy1
Author-email: lenvy1 <lenvy1@163.com>
Project-URL: Homepage, https://github.com/yourusername/htmlplayer
Project-URL: Issues, https://github.com/yourusername/htmlplayer/issues
Keywords: video,player,html5,browser,edge
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: home-page
Dynamic: requires-python


# HTMLPlayer

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

## 安装

```bash
pip install htmlplayer
```

## 快速开始

### 基础用法

```python
from htmlplayer import play_video

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

### 指定窗口大小

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

### 仅使用Edge浏览器

```python
from htmlplayer import play_with_edge

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

### 使用系统默认浏览器

```python
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/` 目录下的示例代码：

```bash
# 简单示例
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
