ms-vite-plugin 1.3.2 → 1.3.3

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/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/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/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.3",
   "type": "commonjs",
   "license": "MIT",
   "publishConfig": {