htmlplayer 0.1.1__tar.gz → 0.2.0__tar.gz

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlplayer
-Version: 0.1.1
+Version: 0.2.0
 Summary: 一个简单的HTML视频播放器，使用Edge浏览器或系统默认浏览器播放视频
 Home-page: https://github.com/yourusername/htmlplayer
 Author: lenvy1
@@ -49,12 +49,6 @@ play_video('https://example.com/video.mp4')
 play_video('https://example.com/video.mp4', width=1280, height=720)
 ```
 
-### 指定视频宽高比
-
-```python
-play_video('https://example.com/video.mp4', video_aspect_ratio=21/9)
-```
-
 ### 仅使用Edge浏览器
 
 ```python
@@ -73,7 +67,7 @@ play_with_browser('https://example.com/video.mp4')
 
 ## API 文档
 
-### play_video(url, width=None, height=None, video_aspect_ratio=16/9, use_edge=True, use_browser_fallback=True)
+### play_video(url, width=None, height=None, use_edge=True, use_browser_fallback=True)
 
 使用Edge浏览器或系统默认浏览器播放视频。
 
@@ -81,18 +75,17 @@ play_with_browser('https://example.com/video.mp4')
 - `url` (str): 视频URL地址
 - `width` (int, optional): 窗口宽度
 - `height` (int, optional): 窗口高度
-- `video_aspect_ratio` (float): 视频宽高比，默认16:9
 - `use_edge` (bool): 是否优先使用Edge浏览器，默认True
 - `use_browser_fallback` (bool): Edge不可用时是否使用默认浏览器，默认True
 
 **返回:**
 - `bool`: 播放是否成功启动
 
-### play_with_edge(url, width=None, height=None, video_aspect_ratio=16/9)
+### play_with_edge(url, width=None, height=None)
 
 仅使用Edge浏览器播放视频。
 
-### play_with_browser(url, width=None, height=None, video_aspect_ratio=16/9)
+### play_with_browser(url, width=None, height=None)
 
 使用系统默认浏览器播放视频。
 
@@ -100,9 +93,26 @@ play_with_browser('https://example.com/video.mp4')
 
 查找Microsoft Edge浏览器的安装路径。
 
-### calculate_window_size(screen_width=None, screen_height=None, video_aspect_ratio=16/9, scale=0.5)
+**返回:**
+- `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)
+
+**自动缩放规则:**
+- 竖屏视频 (宽高比 <= 0.6): 自动使用 90% 尺寸
+- 高度 >= 1080: 自动使用 50% 尺寸
+- 高度 >= 720: 自动使用 60% 尺寸
+- 高度 >= 480: 自动使用 100% 尺寸
 
 ## 系统要求
 
@@ -129,4 +139,3 @@ python -c "import htmlplayer; import os; print(os.path.join(os.path.dirname(html
 ## 许可证
 
 MIT License
-

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/README.md

@@ -25,12 +25,6 @@ play_video('https://example.com/video.mp4')
 play_video('https://example.com/video.mp4', width=1280, height=720)
 ```
 
-### 指定视频宽高比
-
-```python
-play_video('https://example.com/video.mp4', video_aspect_ratio=21/9)
-```
-
 ### 仅使用Edge浏览器
 
 ```python
@@ -49,7 +43,7 @@ play_with_browser('https://example.com/video.mp4')
 
 ## API 文档
 
-### play_video(url, width=None, height=None, video_aspect_ratio=16/9, use_edge=True, use_browser_fallback=True)
+### play_video(url, width=None, height=None, use_edge=True, use_browser_fallback=True)
 
 使用Edge浏览器或系统默认浏览器播放视频。
 
@@ -57,18 +51,17 @@ play_with_browser('https://example.com/video.mp4')
 - `url` (str): 视频URL地址
 - `width` (int, optional): 窗口宽度
 - `height` (int, optional): 窗口高度
-- `video_aspect_ratio` (float): 视频宽高比，默认16:9
 - `use_edge` (bool): 是否优先使用Edge浏览器，默认True
 - `use_browser_fallback` (bool): Edge不可用时是否使用默认浏览器，默认True
 
 **返回:**
 - `bool`: 播放是否成功启动
 
-### play_with_edge(url, width=None, height=None, video_aspect_ratio=16/9)
+### play_with_edge(url, width=None, height=None)
 
 仅使用Edge浏览器播放视频。
 
-### play_with_browser(url, width=None, height=None, video_aspect_ratio=16/9)
+### play_with_browser(url, width=None, height=None)
 
 使用系统默认浏览器播放视频。
 
@@ -76,9 +69,26 @@ play_with_browser('https://example.com/video.mp4')
 
 查找Microsoft Edge浏览器的安装路径。
 
-### calculate_window_size(screen_width=None, screen_height=None, video_aspect_ratio=16/9, scale=0.5)
+**返回:**
+- `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)
+
+**自动缩放规则:**
+- 竖屏视频 (宽高比 <= 0.6): 自动使用 90% 尺寸
+- 高度 >= 1080: 自动使用 50% 尺寸
+- 高度 >= 720: 自动使用 60% 尺寸
+- 高度 >= 480: 自动使用 100% 尺寸
 
 ## 系统要求
 
@@ -105,4 +115,3 @@ python -c "import htmlplayer; import os; print(os.path.join(os.path.dirname(html
 ## 许可证
 
 MIT License
-

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/htmlplayer/__init__.py

@@ -7,7 +7,7 @@ from .core import (
     calculate_window_size
 )
 
-__version__ = "0.1.1"
+__version__ = "0.2.0"
 __all__ = [
     "play_video",
     "play_with_edge",

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/htmlplayer/core.py

@@ -15,48 +15,51 @@ def find_edge_browser():
     return None
 
 
-def calculate_window_size(width, height, scale=0.5):
+def calculate_window_size(width=None, height=None, scale=None):
     """
     根据输入的宽高计算合适的窗口大小（严格等比缩放）
-    
+
     参数:
-        width (int/float): 目标宽度（像素）
-        height (int/float): 目标高度（像素）
-        scale (float): 窗口相对于输入尺寸的缩放比例，默认0.5（即50%尺寸）
-    
+        width (int/float, optional): 目标宽度（像素），不传则自动检测屏幕宽度
+        height (int/float, optional): 目标高度（像素），不传则自动检测屏幕高度
+        scale (float, optional): 窗口相对于输入尺寸的缩放比例，默认None表示自动计算
+
     返回:
         tuple: 包含窗口宽度和高度的元组 (final_width, final_height)，均为真实的浮点数
     """
-    # 1. 跨平台自动检测屏幕分辨率
     if width is None or height is None:
         try:
             import tkinter as tk
             root = tk.Tk()
-            root.withdraw()  # 隐藏主窗口，避免闪烁
+            root.withdraw()
             width = root.winfo_screenwidth()
             height = root.winfo_screenheight()
             root.destroy()
         except Exception as e:
-            raise RuntimeError(f"无法自动获取屏幕分辨率，请手动传入 screen_width 和 screen_height。错误信息: {e}")
-    # 2. 根据传入的宽高直接计算目标宽高比
+            raise RuntimeError(f"无法自动获取屏幕分辨率，请手动传入 width 和 height。错误信息: {e}")
+
     target_ratio = width / height
 
-    # 3. 针对竖屏视频的视觉体验优化
-    # 竖屏视频(如 9:16，比例约为 0.56)若按默认比例缩放会导致画面过小，因此放大显示
+    auto_scale = 0.5
     if target_ratio <= 0.6:
-        scale = 0.9 
+        auto_scale = 0.9
+    elif height >= 1080:
+        auto_scale = 0.5
+    elif height >= 720:
+        auto_scale = 0.6
+    elif height >= 480:
+        auto_scale = 1.0
+
+    if scale is None:
+        scale = auto_scale
 
-    # 4. 计算允许的最大边界
     max_width = width * scale
     max_height = height * scale
 
-    # 5. 核心等比缩放计算（取最小限制比例，确保不超出屏幕且保持绝对比例）
     if max_width / target_ratio <= max_height:
-        # 宽度先触达边界，以宽度为基准计算高度
         final_width = max_width
         final_height = max_width / target_ratio
     else:
-        # 高度先触达边界，以高度为基准计算宽度
         final_height = max_height
         final_width = max_height * target_ratio
 

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/htmlplayer/examples/advanced_example.py

@@ -11,10 +11,10 @@ def check_edge_availability():
     """检查Edge浏览器是否可用"""
     edge_path = find_edge_browser()
     if edge_path:
-        print(f"✅ Edge浏览器可用: {edge_path}")
+        print(f"Edge浏览器可用: {edge_path}")
         return True
     else:
-        print("❌ Edge浏览器未找到")
+        print("Edge浏览器未找到")
         return False
 
 
@@ -22,45 +22,47 @@ def demo_window_calculation():
     """演示窗口大小计算"""
     print("\n窗口大小计算演示:")
     print("-" * 30)
-    
-    # 获取屏幕尺寸并计算
+
+    # 自动检测屏幕尺寸并计算默认窗口大小
     width, height = calculate_window_size()
-    print(f"默认窗口大小: {width}x{height}")
-    
-    # 不同宽高比
-    for aspect_ratio in [16/9, 21/9, 4/3, 9/16]:
-        w, h = calculate_window_size(video_aspect_ratio=aspect_ratio)
-        print(f"宽高比 {aspect_ratio:.2f}: {w}x{h}")
+    print(f"默认窗口大小: {int(width)}x{int(height)}")
+
+    # 指定输入尺寸自动计算缩放
+    for test_w, test_h in [(1920, 1080), (1280, 720), (640, 480), (1080, 1920)]:
+        w, h = calculate_window_size(width=test_w, height=test_h)
+        print(f"输入 {test_w}x{test_h} -> 窗口 {int(w)}x{int(h)}")
+
+    # 指定自定义缩放比例
+    w, h = calculate_window_size(width=1920, height=1080, scale=0.3)
+    print(f"自定义缩放 scale=0.3: {int(w)}x{int(h)}")
 
 
 def demo_different_configs():
     """演示不同配置的播放"""
     print("\n不同配置演示:")
     print("-" * 30)
-    
-    # 这里只是示例，实际运行时可以取消注释
+
     print("1. 仅Edge浏览器（无回退）:")
     print("   play_video(url, use_edge=True, use_browser_fallback=False)")
-    
+
     print("\n2. 强制使用系统浏览器:")
     print("   play_video(url, use_edge=False, use_browser_fallback=True)")
-    
-    print("\n3. 自定义窗口:")
+
+    print("\n3. 自定义窗口大小:")
     print("   play_video(url, width=1920, height=1080)")
 
 
 def main():
     print("HTMLPlayer 高级示例")
     print("=" * 50)
-    
+
     check_edge_availability()
     demo_window_calculation()
     demo_different_configs()
-    
+
     print("\n" + "=" * 50)
     print("提示：参考 simple_example.py 来运行实际的视频播放")
 
 
 if __name__ == '__main__':
     main()
-

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/htmlplayer/examples/simple_example.py

@@ -9,26 +9,26 @@ from htmlplayer import play_video, play_with_edge, play_with_browser
 def main():
     print("HTMLPlayer 视频播放库 - 简单示例")
     print("=" * 50)
-    
+
     print("\n1. 基础用法:")
     print("   from htmlplayer import play_video")
     print("   play_video('https://example.com/video.m3u8')")
-    
+
     print("\n2. 指定窗口大小:")
     print("   play_video('https://example.com/video.m3u8', width=1280, height=720)")
-    
+
     print("\n3. 仅使用Edge浏览器:")
     print("   from htmlplayer import play_with_edge")
     print("   play_with_edge('https://example.com/video.m3u8')")
-    
+
     print("\n4. 使用系统默认浏览器:")
     print("   from htmlplayer import play_with_browser")
     print("   play_with_browser('https://example.com/video.m3u8')")
-    
+
     print("\n" + "=" * 50)
-    print("提示：取消下面的注释可以实际运行一个示例")
+    print("提示：取消下面代码的注释可以实际运行一个示例")
     print("=" * 50)
-    
+
     # 实际演示（取消注释以运行）
     # print("\n正在播放示例视频...")
     # play_video('https://jx.xmflv.com/?url=https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8')
@@ -36,4 +36,3 @@ def main():
 
 if __name__ == '__main__':
     main()
-

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/htmlplayer.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlplayer
-Version: 0.1.1
+Version: 0.2.0
 Summary: 一个简单的HTML视频播放器，使用Edge浏览器或系统默认浏览器播放视频
 Home-page: https://github.com/yourusername/htmlplayer
 Author: lenvy1
@@ -49,12 +49,6 @@ play_video('https://example.com/video.mp4')
 play_video('https://example.com/video.mp4', width=1280, height=720)
 ```
 
-### 指定视频宽高比
-
-```python
-play_video('https://example.com/video.mp4', video_aspect_ratio=21/9)
-```
-
 ### 仅使用Edge浏览器
 
 ```python
@@ -73,7 +67,7 @@ play_with_browser('https://example.com/video.mp4')
 
 ## API 文档
 
-### play_video(url, width=None, height=None, video_aspect_ratio=16/9, use_edge=True, use_browser_fallback=True)
+### play_video(url, width=None, height=None, use_edge=True, use_browser_fallback=True)
 
 使用Edge浏览器或系统默认浏览器播放视频。
 
@@ -81,18 +75,17 @@ play_with_browser('https://example.com/video.mp4')
 - `url` (str): 视频URL地址
 - `width` (int, optional): 窗口宽度
 - `height` (int, optional): 窗口高度
-- `video_aspect_ratio` (float): 视频宽高比，默认16:9
 - `use_edge` (bool): 是否优先使用Edge浏览器，默认True
 - `use_browser_fallback` (bool): Edge不可用时是否使用默认浏览器，默认True
 
 **返回:**
 - `bool`: 播放是否成功启动
 
-### play_with_edge(url, width=None, height=None, video_aspect_ratio=16/9)
+### play_with_edge(url, width=None, height=None)
 
 仅使用Edge浏览器播放视频。
 
-### play_with_browser(url, width=None, height=None, video_aspect_ratio=16/9)
+### play_with_browser(url, width=None, height=None)
 
 使用系统默认浏览器播放视频。
 
@@ -100,9 +93,26 @@ play_with_browser('https://example.com/video.mp4')
 
 查找Microsoft Edge浏览器的安装路径。
 
-### calculate_window_size(screen_width=None, screen_height=None, video_aspect_ratio=16/9, scale=0.5)
+**返回:**
+- `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)
+
+**自动缩放规则:**
+- 竖屏视频 (宽高比 <= 0.6): 自动使用 90% 尺寸
+- 高度 >= 1080: 自动使用 50% 尺寸
+- 高度 >= 720: 自动使用 60% 尺寸
+- 高度 >= 480: 自动使用 100% 尺寸
 
 ## 系统要求
 
@@ -129,4 +139,3 @@ python -c "import htmlplayer; import os; print(os.path.join(os.path.dirname(html
 ## 许可证
 
 MIT License
-

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "htmlplayer"
-version = "0.1.1"
+version = "0.2.0"
 authors = [
   { name = "lenvy1", email = "lenvy1@163.com" }
 ]

{htmlplayer-0.1.1 → htmlplayer-0.2.0}/setup.py

@@ -3,7 +3,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="htmlplayer",
-    version="0.1.1",
+    version="0.2.0",
     packages=find_packages(),
     include_package_data=True,
     description="一个简单的HTML视频播放器，使用Edge浏览器或系统默认浏览器播放视频",