htmlplayer 0.1.2__tar.gz → 0.3.0__tar.gz

{htmlplayer-0.1.2 → htmlplayer-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlplayer
-Version: 0.1.2
+Version: 0.3.0
 Summary: 一个简单的HTML视频播放器，使用Edge浏览器或系统默认浏览器播放视频
 Home-page: https://github.com/yourusername/htmlplayer
 Author: lenvy1
@@ -93,9 +93,25 @@ play_with_browser('https://example.com/video.mp4')
 
 查找Microsoft Edge浏览器的安装路径。
 
-### calculate_window_size(width=None, height=None, 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)
 
-计算合适的窗口大小。
+**自动缩放规则:**
+- 横屏视频（宽 >= 高）：缩放到屏幕的 50%
+- 竖屏视频（宽 < 高）：缩放到屏幕的 80%
+- 严格保持原视频纵横比
 
 ## 系统要求
 

{htmlplayer-0.1.2 → htmlplayer-0.3.0}/README.md

@@ -69,9 +69,25 @@ play_with_browser('https://example.com/video.mp4')
 
 查找Microsoft Edge浏览器的安装路径。
 
-### calculate_window_size(width=None, height=None, 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)
 
-计算合适的窗口大小。
+**自动缩放规则:**
+- 横屏视频（宽 >= 高）：缩放到屏幕的 50%
+- 竖屏视频（宽 < 高）：缩放到屏幕的 80%
+- 严格保持原视频纵横比
 
 ## 系统要求
 

{htmlplayer-0.1.2 → htmlplayer-0.3.0}/htmlplayer/__init__.py

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

{htmlplayer-0.1.2 → htmlplayer-0.3.0}/htmlplayer/core.py

@@ -1,6 +1,7 @@
 
 import subprocess
 import os
+from pathlib import Path
 
 
 def find_edge_browser():
@@ -15,50 +16,66 @@ 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):
     """
-    根据输入的宽高计算合适的窗口大小（严格等比缩放）
-    
+    根据视频宽高计算合适的窗口大小（严格等比缩放）。
+
+    规则：
+    - 横屏视频（宽 >= 高）：缩放到屏幕的 50%
+    - 竖屏视频（宽 < 高）：缩放到屏幕的 80%
+    - 严格保持原视频纵横比
+
     参数:
-        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()  # 隐藏主窗口，避免闪烁
-            width = root.winfo_screenwidth()
-            height = root.winfo_screenheight()
-            root.destroy()
-        except Exception as e:
-            raise RuntimeError(f"无法自动获取屏幕分辨率，请手动传入 screen_width 和 screen_height。错误信息: {e}")
-    # 2. 根据传入的宽高直接计算目标宽高比
-    target_ratio = width / height
-
-    # 3. 针对竖屏视频的视觉体验优化
-    # 竖屏视频(如 9:16，比例约为 0.56)若按默认比例缩放会导致画面过小，因此放大显示
-    if target_ratio <= 0.6:
-        scale = 0.9 
-
-    # 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
+    # 1. 检测屏幕尺寸（作为缩放参考基准）
+    try:
+        import tkinter as tk
+        root = tk.Tk()
+        root.withdraw()
+        screen_width = root.winfo_screenwidth()
+        screen_height = root.winfo_screenheight()
+        root.destroy()
+    except Exception as e:
+        raise RuntimeError(f"无法自动获取屏幕分辨率，请手动传入 width 和 height。错误信息: {e}")
+
+    # 2. 确定视频尺寸：用户传入则用用户的，否则用屏幕尺寸作为参考
+    video_width = width if width is not None else screen_width
+    video_height = height if height is not None else screen_height
+
+    # 3. 判断横屏/竖屏并确定自动缩放比例
+    if scale is None:
+        if video_width >= video_height:
+            # 横屏视频 → 50% 屏幕
+            scale = 0.5
+        else:
+            # 竖屏视频 → 90% 屏幕
+            scale = 0.9
+
+    # 4. 目标区域：屏幕 * scale
+    target_width = screen_width * scale
+    target_height = screen_height * scale
+
+    # 5. 在目标区域内严格按原视频纵横比缩放（取较小边做基准，确保不溢出）
+    video_ratio = video_width / video_height
+    target_ratio = target_width / target_height
+
+    if video_ratio >= target_ratio:
+        # 视频更宽 → 以宽度为基准
+        final_width = target_width
+        final_height = target_width / video_ratio
     else:
-        # 高度先触达边界，以高度为基准计算宽度
-        final_height = max_height
-        final_width = max_height * target_ratio
+        # 视频更高 → 以高度为基准
+        final_height = target_height
+        final_width = target_height * video_ratio
+
+    if video_width >= video_height:
+        final_height = final_height + 30
 
     return final_width, final_height
 
@@ -82,8 +99,8 @@ def play_video(url, width=None, height=None,
         raise ValueError("url参数无效，必须提供有效的URL字符串")
 
     url = url.strip()
-    if not url.startswith('http'):
-        raise ValueError("url必须以http或https开头")
+
+    url = Path(url).absolute().as_uri()
 
     final_width, final_height = calculate_window_size(width=width, height=height)
 

{htmlplayer-0.1.2 → htmlplayer-0.3.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,23 +22,37 @@ def demo_window_calculation():
     """演示窗口大小计算"""
     print("\n窗口大小计算演示:")
     print("-" * 30)
-    
-    # 获取屏幕尺寸并计算默认窗口大小
+
+    # 自动检测屏幕尺寸并计算默认窗口大小
     width, height = calculate_window_size()
-    print(f"默认窗口大小: {int(width)}x{int(height)}")
+    print(f"默认（横屏参考）: {int(width)}x{int(height)}")
+
+    # 横屏视频（50% 屏幕）
+    for test_w, test_h in [(1920, 1080), (1280, 720)]:
+        w, h = calculate_window_size(width=test_w, height=test_h)
+        print(f"横屏视频 {test_w}x{test_h} -> 50% 屏幕: {int(w)}x{int(h)}")
+
+    # 竖屏视频（80% 屏幕）
+    for test_w, test_h in [(1080, 1920), (720, 1280)]:
+        w, h = calculate_window_size(width=test_w, height=test_h)
+        print(f"竖屏视频 {test_w}x{test_h} -> 80% 屏幕: {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("   play_video(url, width=1920, height=1080)")
 
@@ -46,11 +60,11 @@ def demo_different_configs():
 def main():
     print("HTMLPlayer 高级示例")
     print("=" * 50)
-    
+
     check_edge_availability()
     demo_window_calculation()
     demo_different_configs()
-    
+
     print("\n" + "=" * 50)
     print("提示：参考 simple_example.py 来运行实际的视频播放")
 

{htmlplayer-0.1.2 → htmlplayer-0.3.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.2 → htmlplayer-0.3.0}/htmlplayer.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: htmlplayer
-Version: 0.1.2
+Version: 0.3.0
 Summary: 一个简单的HTML视频播放器，使用Edge浏览器或系统默认浏览器播放视频
 Home-page: https://github.com/yourusername/htmlplayer
 Author: lenvy1
@@ -93,9 +93,25 @@ play_with_browser('https://example.com/video.mp4')
 
 查找Microsoft Edge浏览器的安装路径。
 
-### calculate_window_size(width=None, height=None, 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)
 
-计算合适的窗口大小。
+**自动缩放规则:**
+- 横屏视频（宽 >= 高）：缩放到屏幕的 50%
+- 竖屏视频（宽 < 高）：缩放到屏幕的 80%
+- 严格保持原视频纵横比
 
 ## 系统要求
 

{htmlplayer-0.1.2 → htmlplayer-0.3.0}/pyproject.toml

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

{htmlplayer-0.1.2 → htmlplayer-0.3.0}/setup.py

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