ms-vite-plugin 1.4.6 → 1.4.8

package/docs/api/pip.md

@@ -1,12 +1,12 @@
 # 悬浮窗模块 (PIP)
 
-悬浮窗模块提供了画中画（Picture in Picture）功能，允许在应用中显示悬浮的日志窗口，支持自定义样式和控制脚本启停。
+悬浮窗模块提供了画中画（Picture in Picture）功能，允许在应用中显示悬浮的日志窗口，支持自定义样式。
 
 ## 功能特性
 
 - 🖼️ **悬浮窗显示** - 支持在屏幕上显示悬浮的日志窗口
 - 🎨 **自定义样式** - 可配置窗口大小、字体、颜色等
-- 🎮 **脚本控制** - 支持通过悬浮窗控制脚本的启停
+- 🎮 **脚本控制配置** - 保留脚本控制配置接口，Video Call PiP 链路不再提供播放/暂停按钮回调
 
 ## 接口定义
 
@@ -15,11 +15,11 @@
 ```typescript
 interface LogViewParams {
   /**
-   * 悬浮窗宽度，不能小于 100
+   * 悬浮窗内容宽度，默认 300
    */
   width: number;
   /**
-   * 悬浮窗高度，不能小于 100
+   * 悬浮窗内容高度，支持最低 0.1pt，实际显示由 iOS Video Call PiP 决定
    */
   height: number;
   /**
@@ -41,8 +41,8 @@ interface LogViewParams {
 
 | 参数              | 类型   | 是否必填 | 默认值 | 描述                                    |
 | ----------------- | ------ | -------- | ------ | --------------------------------------- |
-| `width`           | number | 是       |        | 悬浮窗宽度（像素），最小值为 100        |
-| `height`          | number | 是       |        | 悬浮窗高度（像素），最小值为 100        |
+| `width`           | number | 是       |        | 悬浮窗内容宽度，默认 300                |
+| `height`          | number | 是       |        | 悬浮窗内容高度，支持最低 0.1pt          |
 | `textSize`        | number | 是       |        | 日志文字大小（像素）                    |
 | `textColor`       | string | 是       |        | 文字颜色，十六进制格式（如：`#FFFFFF`） |
 | `backgroundColor` | string | 是       |        | 背景颜色，十六进制格式（如：`#000000`） |
@@ -55,7 +55,7 @@ interface LogViewParams {
 function setLogViewParams(params: LogViewParams): void;
 ```
 
-设置悬浮窗日志窗口的显示参数，必须在显示日志窗口之前调用才会生效。
+设置悬浮窗日志窗口的显示参数。显示前调用会影响首次高度；显示后再次调用会同步更新当前 Video Call PiP 内容尺寸。
 
 **参数：**
 
@@ -164,7 +164,7 @@ if (success) {
 function setPipCtrlScript(ctrl: boolean): boolean;
 ```
 
-设置是否允许悬浮窗控制脚本的启停。
+设置是否允许悬浮窗控制脚本的启停。当前 Video Call PiP 链路仅保存配置，不再提供播放/暂停按钮回调。
 
 **参数：**
 
@@ -203,7 +203,7 @@ pip.setLogViewParams({
   backgroundColor: "#1A1A1A", // 深灰色背景
 });
 
-// 2. 允许悬浮窗控制脚本
+// 2. 保存悬浮窗控制脚本配置
 pip.setPipCtrlScript(true);
 
 // 3. 显示悬浮窗
@@ -214,12 +214,12 @@ const showResult = pip.showLogWindow();
 
 1. **前台限制**：所有悬浮窗操作都必须在应用前台状态下进行
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
-3. **参数限制**：悬浮窗的宽度和高度都不能小于 100 像素
-4. **配置时机**：`setLogViewParams()` 必须在 `showLogWindow()` 之前调用
+3. **尺寸限制**：`height` 支持最低 0.1pt，内部最高限制为 220pt；实际悬浮窗显示仍由 iOS Video Call PiP 决定
+4. **配置时机**：`setLogViewParams()` 可在显示前或显示后调用，显示后会同步更新当前内容尺寸
 5. **颜色格式**：颜色值必须使用十六进制格式（如：`#FFFFFF`）
 6. **尺寸适配**：iOS 系统会对画中画窗口的尺寸进行限制和自动调整，实际显示的画中画窗口大小可能与设置的 `width` 和 `height` 参数不完全一致
 7. **内容渲染**：画中画内容渲染会自动适配系统分配的实际窗口尺寸，而不是使用配置的尺寸参数
-8. **脚本控制**：如果已调用 `setPipCtrlScript(true)`，则可以通过悬浮窗控制脚本的启停
+8. **脚本控制**：Video Call PiP 链路不再提供播放/暂停按钮回调，`setPipCtrlScript(true)` 当前仅保存配置
 
 ## 故障排除
 
@@ -227,7 +227,7 @@ const showResult = pip.showLogWindow();
 
 - 确认设备支持悬浮窗功能
 - 检查悬浮窗权限是否已开启
-- 确认参数配置是否正确（宽高不小于 100）
+- 确认参数配置是否正确（高度不低于 0.1pt）
 
 ### 悬浮窗显示异常
 
@@ -237,6 +237,5 @@ const showResult = pip.showLogWindow();
 
 ### 脚本控制无效
 
-- 确认已调用 `setPipCtrlScript(true)`
-- 检查悬浮窗是否正常显示
-- 验证脚本运行状态是否正常
+- 当前 Video Call PiP 链路不再提供播放/暂停按钮回调
+- `setPipCtrlScript(true)` 仅保存配置，不会直接驱动脚本启停

package/docs/apicn/pip.md

@@ -1,12 +1,12 @@
 # 悬浮窗模块 ($悬浮窗)
 
-悬浮窗模块提供了画中画（Picture in Picture）功能，允许在应用中显示悬浮的日志窗口，支持自定义样式和控制脚本启停。
+悬浮窗模块提供了画中画（Picture in Picture）功能，允许在应用中显示悬浮的日志窗口，支持自定义样式。
 
 ## 功能特性
 
 - 🖼️ **悬浮窗显示** - 支持在屏幕上显示悬浮的日志窗口
 - 🎨 **自定义样式** - 可配置窗口大小、字体、颜色等
-- 🎮 **脚本控制** - 支持通过悬浮窗控制脚本的启停
+- 🎮 **脚本控制配置** - 保留脚本控制配置接口，Video Call PiP 链路不再提供播放/暂停按钮回调
 
 ## 接口定义
 
@@ -15,11 +15,11 @@
 ```typescript
 interface 日志窗口参数 {
   /**
-   * 悬浮窗宽度，不能小于 100
+   * 悬浮窗内容宽度，默认 300
    */
   width: 数字;
   /**
-   * 悬浮窗高度，不能小于 100
+   * 悬浮窗内容高度，支持最低 0.1pt，实际显示由 iOS Video Call PiP 决定
    */
   height: 数字;
   /**
@@ -41,8 +41,8 @@ interface 日志窗口参数 {
 
 | 参数              | 类型   | 是否必填 | 默认值 | 描述                                    |
 | ----------------- | ------ | -------- | ------ | --------------------------------------- |
-| `width`           | 数字   | 是       |        | 悬浮窗宽度（像素），最小值为 100        |
-| `height`          | 数字   | 是       |        | 悬浮窗高度（像素），最小值为 100        |
+| `width`           | 数字   | 是       |        | 悬浮窗内容宽度，默认 300                |
+| `height`          | 数字   | 是       |        | 悬浮窗内容高度，支持最低 0.1pt          |
 | `textSize`        | 数字   | 是       |        | 日志文字大小（像素）                    |
 | `textColor`       | 字符串 | 是       |        | 文字颜色，十六进制格式（如：`#FFFFFF`） |
 | `backgroundColor` | 字符串 | 是       |        | 背景颜色，十六进制格式（如：`#000000`） |
@@ -55,7 +55,7 @@ interface 日志窗口参数 {
 function 设置日志视图参数(参数: 日志窗口参数): 无返回值;
 ```
 
-设置悬浮窗日志窗口的显示参数，必须在显示日志窗口之前调用才会生效。
+设置悬浮窗日志窗口的显示参数。显示前调用会影响首次高度；显示后再次调用会同步更新当前 Video Call PiP 内容尺寸。
 
 **参数：**
 
@@ -164,7 +164,7 @@ if (是否成功) {
 function 设置是否允许控制脚本启停(是否允许: 布尔值): 布尔值;
 ```
 
-设置是否允许悬浮窗控制脚本的启停。
+设置是否允许悬浮窗控制脚本的启停。当前 Video Call PiP 链路仅保存配置，不再提供播放/暂停按钮回调。
 
 **参数：**
 
@@ -203,7 +203,7 @@ $悬浮窗.设置日志视图参数({
   backgroundColor: "#1A1A1A", // 深灰色背景
 });
 
-// 2. 允许悬浮窗控制脚本
+// 2. 保存悬浮窗控制脚本配置
 $悬浮窗.设置是否允许控制脚本启停(true);
 
 // 3. 显示悬浮窗
@@ -214,12 +214,12 @@ const showResult = $悬浮窗.显示日志窗口();
 
 1. **前台限制**：所有悬浮窗操作都必须在应用前台状态下进行
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
-3. **参数限制**：悬浮窗的宽度和高度都不能小于 100 像素
-4. **配置时机**：`设置日志视图参数()` 必须在 `显示日志窗口()` 之前调用
+3. **尺寸限制**：`height` 支持最低 0.1pt，内部最高限制为 220pt；实际悬浮窗显示仍由 iOS Video Call PiP 决定
+4. **配置时机**：`设置日志视图参数()` 可在显示前或显示后调用，显示后会同步更新当前内容尺寸
 5. **颜色格式**：颜色值必须使用十六进制格式（如：`#FFFFFF`）
 6. **尺寸适配**：iOS 系统会对画中画窗口的尺寸进行限制和自动调整，实际显示的画中画窗口大小可能与设置的 `width` 和 `height` 参数不完全一致
 7. **内容渲染**：画中画内容渲染会自动适配系统分配的实际窗口尺寸，而不是使用配置的尺寸参数
-8. **脚本控制**：如果已调用 `设置是否允许脚本控制(true)`，则可以通过悬浮窗控制脚本的启停
+8. **脚本控制**：Video Call PiP 链路不再提供播放/暂停按钮回调，`设置是否允许控制脚本启停(true)` 当前仅保存配置
 
 ## 故障排除
 
@@ -227,7 +227,7 @@ const showResult = $悬浮窗.显示日志窗口();
 
 - 确认设备支持悬浮窗功能
 - 检查悬浮窗权限是否已开启
-- 确认参数配置是否正确（宽高不小于 100）
+- 确认参数配置是否正确（高度不低于 0.1pt）
 
 ### 悬浮窗显示异常
 
@@ -237,6 +237,5 @@ const showResult = $悬浮窗.显示日志窗口();
 
 ### 脚本控制无效
 
-- 确认已调用 `设置是否允许脚本控制(true)`
-- 检查悬浮窗是否正常显示
-- 验证脚本运行状态是否正常
+- 当前 Video Call PiP 链路不再提供播放/暂停按钮回调
+- `设置是否允许控制脚本启停(true)` 仅保存配置，不会直接驱动脚本启停

package/docs/apipython/pip.md

@@ -1,12 +1,12 @@
 # 悬浮窗模块 (PIP)
 
-悬浮窗模块提供了画中画（Picture in Picture）功能，允许在应用中显示悬浮的日志窗口，支持自定义样式和控制脚本启停。
+悬浮窗模块提供了画中画（Picture in Picture）功能，允许在应用中显示悬浮的日志窗口，支持自定义样式。
 
 ## 功能特性
 
 - **悬浮窗显示**: 支持在屏幕上显示悬浮的日志窗口
 - **自定义样式**: 可配置窗口大小、字体、颜色等
-- **脚本控制**: 支持通过悬浮窗控制脚本的启停
+- **脚本控制配置**: 保留脚本控制配置接口，Video Call PiP 链路不再提供播放/暂停按钮回调
 
 ## 类型定义
 
@@ -18,8 +18,8 @@
 from typing import TypedDict
 
 class LogViewParams(TypedDict):
-    width: int            # 悬浮窗宽度，不能小于 100
-    height: int           # 悬浮窗高度，不能小于 100
+    width: float          # 悬浮窗内容宽度，默认 300
+    height: float         # 悬浮窗内容高度，支持最低 0.1pt
     textSize: int         # 日志的字体大小
     textColor: str        # 日志的文字颜色，格式如 #FFFFFF
     backgroundColor: str  # 日志的背景颜色，格式如 #000000
@@ -29,7 +29,7 @@ class LogViewParams(TypedDict):
 
 ### setLogViewParams - 设置悬浮窗显示参数
 
-设置悬浮窗日志窗口的显示参数，必须在显示日志窗口之前调用才会生效。
+设置悬浮窗日志窗口的显示参数。显示前调用会影响首次高度；显示后再次调用会同步更新当前 Video Call PiP 内容尺寸。
 
 ```python
 def setLogViewParams(params: LogViewParams) -> None
@@ -145,7 +145,7 @@ else:
 
 ### setPipCtrlScript - 设置脚本控制权限
 
-设置是否允许悬浮窗控制脚本的启停。
+设置是否允许悬浮窗控制脚本的启停。当前 Video Call PiP 链路仅保存配置，不再提供播放/暂停按钮回调。
 
 ```python
 def setPipCtrlScript(ctrl: bool) -> bool
@@ -192,7 +192,7 @@ pip.setLogViewParams({
     "backgroundColor": "#1A1A1A" # 深灰色背景
 })
 
-# 2. 允许悬浮窗控制脚本
+# 2. 保存悬浮窗控制脚本配置
 pip.setPipCtrlScript(True)
 
 # 3. 显示悬浮窗
@@ -203,12 +203,12 @@ pip.showLogWindow()
 
 1. **前台限制**：所有悬浮窗操作都必须在应用前台状态下进行
 2. **设备兼容性**：仅支持 iOS 15+ 且具备画中画功能的设备
-3. **参数限制**：悬浮窗的宽度和高度都不能小于 100 像素
-4. **配置时机**：`setLogViewParams()` 必须在 `showLogWindow()` 之前调用
+3. **尺寸限制**：`height` 支持最低 0.1pt，内部最高限制为 220pt；实际悬浮窗显示仍由 iOS Video Call PiP 决定
+4. **配置时机**：`setLogViewParams()` 可在显示前或显示后调用，显示后会同步更新当前内容尺寸
 5. **颜色格式**：颜色值必须使用十六进制格式（如：`#FFFFFF`）
 6. **尺寸适配**：iOS 系统会对画中画窗口的尺寸进行限制和自动调整，实际显示的画中画窗口大小可能与设置的 `width` 和 `height` 参数不完全一致
 7. **内容渲染**：画中画内容渲染会自动适配系统分配的实际窗口尺寸，而不是使用配置的尺寸参数
-8. **脚本控制**：如果已调用 `setPipCtrlScript(True)`，则可以通过悬浮窗控制脚本的启停
+8. **脚本控制**：Video Call PiP 链路不再提供播放/暂停按钮回调，`setPipCtrlScript(True)` 当前仅保存配置
 
 ## 故障排除
 
@@ -216,7 +216,7 @@ pip.showLogWindow()
 
 - 确认设备支持悬浮窗功能
 - 检查悬浮窗权限是否已开启
-- 确认参数配置是否正确（宽高不小于 100）
+- 确认参数配置是否正确（高度不低于 0.1pt）
 
 ### 悬浮窗显示异常
 
@@ -226,6 +226,5 @@ pip.showLogWindow()
 
 ### 脚本控制无效
 
-- 确认已调用 `setPipCtrlScript(True)`
-- 检查悬浮窗是否正常显示
-- 验证脚本运行状态是否正常
+- 当前 Video Call PiP 链路不再提供播放/暂停按钮回调
+- `setPipCtrlScript(True)` 仅保存配置，不会直接驱动脚本启停

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-vite-plugin",
-  "version": "1.4.6",
+  "version": "1.4.8",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {