ms-vite-plugin 1.3.2 → 1.3.4

package/docs/api/device.md

@@ -316,6 +316,53 @@ function setScreenBrightness(brightness: number): boolean;
 device.setScreenBrightness(0.5);
 ```
 
+### getVolume - 获取系统音量。
+
+```typescript
+function getVolume(): number;
+```
+
+**返回值：**
+
+| 类型     | 描述                     |
+| -------- | ------------------------ |
+| `number` | 系统音量，范围 `0.0-1.0` |
+
+**示例：**
+
+```typescript
+// 获取系统音量
+const volume = device.getVolume();
+logi(`系统音量: ${volume}`);
+```
+
+### setVolume - 设置系统音量。
+
+设置系统音量，音量范围为 `0.0-1.0`。
+
+```typescript
+function setVolume(volume: number): boolean;
+```
+
+**参数说明：**
+
+| 参数名   | 类型     | 是否必填 | 默认值 | 描述                         |
+| -------- | -------- | -------- | ------ | ---------------------------- |
+| `volume` | `number` | 是       | -      | 目标系统音量，范围 `0.0-1.0` |
+
+**返回值：**
+
+| 类型      | 描述         |
+| --------- | ------------ |
+| `boolean` | 是否设置成功 |
+
+**示例：**
+
+```typescript
+// 设置系统音量到 50%
+device.setVolume(0.5);
+```
+
 ### getOrientation - 获取屏幕方向。
 
 **注意事项**

package/docs/api/hid.md

@@ -775,7 +775,6 @@ function pressButton(
     | "brightnessup"
     | "brightnessdown"
     | "power"
-    | "menu"
     | "snapshot",
 ): boolean;
 ```
@@ -784,7 +783,7 @@ function pressButton(
 
 | 参数名   | 类型   | 是否必填 | 默认值 | 描述                                                                                                                     |
 | -------- | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
+| `button` | string | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 
@@ -908,7 +907,7 @@ hid.back();
 
 ### recent - 最近应用
 
-显示 APP 切换器
+双击 Home 显示 APP 切换器。
 
 ```typescript
 function recent(): boolean;

package/docs/apicn/device.md

@@ -330,6 +330,53 @@ function 设置屏幕亮度(亮度: 数字): 布尔值;
 $设备.设置屏幕亮度(0.5);
 ```
 
+### 获取音量
+
+```typescript
+function 获取音量(): 数字;
+```
+
+**返回值：**
+
+| 类型 | 描述                     |
+| ---- | ------------------------ |
+| 数字 | 系统音量，范围 `0.0-1.0` |
+
+**示例：**
+
+```typescript
+// 获取系统音量
+const 音量 = $设备.获取音量();
+$打印信息日志(`系统音量: ${音量}`);
+```
+
+### 设置音量
+
+设置系统音量，音量范围为 `0.0-1.0`。
+
+```typescript
+function 设置音量(音量: 数字): 布尔值;
+```
+
+**参数说明：**
+
+| 参数名 | 类型 | 是否必填 | 默认值 | 描述                         |
+| ------ | ---- | -------- | ------ | ---------------------------- |
+| `音量` | 数字 | 是       | -      | 目标系统音量，范围 `0.0-1.0` |
+
+**返回值：**
+
+| 类型   | 描述         |
+| ------ | ------------ |
+| 布尔值 | 是否设置成功 |
+
+**示例：**
+
+```typescript
+// 设置系统音量到 50%
+$设备.设置音量(0.5);
+```
+
 ### 获取屏幕方向
 
 **注意事项**

package/docs/apicn/hid.md

@@ -775,7 +775,6 @@ function 按键(
     | "brightnessup"
     | "brightnessdown"
     | "power"
-    | "menu"
     | "snapshot",
 ): 布尔值;
 ```
@@ -784,7 +783,7 @@ function 按键(
 
 | 参数名 | 类型   | 是否必填 | 默认值 | 描述                                                                                                                     |
 | ------ | ------ | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
+| `按键` | 字符串 | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 
@@ -911,7 +910,7 @@ $HID.返回();
 
 ### 最近应用
 
-显示 APP 切换器
+双击 Home 显示 APP 切换器。
 
 ```typescript
 function 最近应用(): 布尔值;

package/docs/apipython/device.md

@@ -310,6 +310,52 @@ from kuaijs import device
 device.setScreenBrightness(0.5)
 ```
 
+### getVolume - 获取系统音量。
+
+```python
+def getVolume() -> float
+```
+
+**返回值：**
+
+| 类型    | 描述                     |
+| ------- | ------------------------ |
+| `float` | 系统音量，范围 `0.0-1.0` |
+
+**示例:**
+
+```python
+from kuaijs import device
+print(device.getVolume())
+```
+
+### setVolume - 设置系统音量。
+
+设置系统音量，音量范围为 `0.0-1.0`。
+
+```python
+def setVolume(volume: float) -> bool
+```
+
+**参数说明：**
+
+| 参数名   | 类型    | 是否必填 | 默认值 | 描述                         |
+| -------- | ------- | -------- | ------ | ---------------------------- |
+| `volume` | `float` | 是       | -      | 目标系统音量，范围 `0.0-1.0` |
+
+**返回值：**
+
+| 类型   | 描述         |
+| ------ | ------------ |
+| `bool` | 是否设置成功 |
+
+**示例:**
+
+```python
+from kuaijs import device
+device.setVolume(0.5)
+```
+
 ### getOrientation - 获取屏幕方向。
 
 **注意事项：**

package/docs/apipython/hid.md

@@ -800,7 +800,6 @@ def pressButton(
         "brightnessup",
         "brightnessdown",
         "power",
-        "menu",
         "snapshot",
     ],
 ) -> bool
@@ -810,7 +809,7 @@ def pressButton(
 
 | 参数名   | 类型    | 是否必填 | 默认值 | 描述                                                                                                                     |
 | -------- | ------- | -------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
-| `button` | Literal | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"menu"` Home/Menu 键 <br>- `"snapshot"` 系统截图键 |
+| `button` | Literal | 是       | -      | 按钮类型： <br>-`"home"` Home 键 <br>- `"volumeup"` 音量上键 <br>- `"volumedown"` 音量下键 <br>- `"mute"` 静音键 <br>- `"playpause"` 播放/暂停键 <br>- `"next"` 下一首/下一章节 <br>- `"prev"` 上一首/上一章节 <br>- `"eject"` 显示/隐藏键盘 <br>- `"globe"` Globe 键 <br>- `"search"` 搜索键 <br>- `"brightnessup"` 调高屏幕亮度 <br>- `"brightnessdown"` 调低屏幕亮度 <br>- `"power"` 电源/锁屏键 <br>- `"snapshot"` 系统截图键 |
 
 **返回值：**
 
@@ -932,7 +931,7 @@ hid.back()
 
 ### recent - 最近应用
 
-显示 APP 切换器
+双击 Home 显示 APP 切换器。
 
 ```python
 def recent() -> bool

package/docs/httpapi/api.md

@@ -300,6 +300,134 @@ GET /api/activeAppInfo
 |»» bundleId|string|true|none|应用包名|none|
 |»» pid|integer|true|none||none|
 
+## GET 获取屏幕亮度
+
+GET /api/getScreenBrightness
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true,
+  "data": 0.5
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+|» data|number|true|none|屏幕亮度|范围 `0.0-1.0`|
+
+## GET 设置屏幕亮度
+
+GET /api/setScreenBrightness
+
+### 请求参数
+
+|名称|位置|类型|必选|中文名|说明|
+|---|---|---|---|---|---|
+|brightness|query|number| 是 |屏幕亮度|范围 `0.0-1.0`|
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+
+## GET 获取系统音量
+
+GET /api/getVolume
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true,
+  "data": 0.5
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+|» data|number|true|none|系统音量|范围 `0.0-1.0`|
+
+## GET 设置系统音量
+
+GET /api/setVolume
+
+### 请求参数
+
+|名称|位置|类型|必选|中文名|说明|
+|---|---|---|---|---|---|
+|volume|query|number| 是 |系统音量|范围 `0.0-1.0`|
+
+> 返回示例
+
+> 200 Response
+
+```json
+{
+  "success": true
+}
+```
+
+### 返回结果
+
+|状态码|状态码含义|说明|数据模型|
+|---|---|---|---|
+|200|[OK](https://tools.ietf.org/html/rfc7231#section-6.3.1)|none|Inline|
+
+### 返回数据结构
+
+状态码 **200**
+
+|名称|类型|必选|约束|中文名|说明|
+|---|---|---|---|---|---|
+|» success|boolean|true|none|是否成功|none|
+
 ## POST 登录接口
 
 POST /api/login

package/package.json

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

package/dist/device.d.ts

@@ -1,32 +0,0 @@
-/**
- * 设备命令选项
- */
-export interface DeviceCliOptions {
-    ip: string;
-    port?: string;
-    path?: string;
-}
-/**
- * 在设备上运行项目（先同步后运行）
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
- */
-export declare function runOnDevice(options: DeviceCliOptions): Promise<void>;
-/**
- * 在设备上预览 UI（先同步后调用 runUI）
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
- */
-export declare function runUIOnDevice(options: DeviceCliOptions): Promise<void>;
-/**
- * 停止设备上的项目
- * @param options 命令选项
- * @returns 执行完成后返回 Promise<void>
- * @example
- * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
- */
-export declare function stopOnDevice(options: DeviceCliOptions): Promise<void>;