---
title: "minimize"
description: "最小化当前 Windows 窗口。"
---


> 最小化当前 Windows 窗口。

## 签名

```ts
KSM.window.minimize(): Promise<{ updated: boolean }>
```

## 平台与权限

| Windows | Android |权限 |
| --- | --- | --- |
|支持 |不支持 | `window.control` |

## 参数

无。

## 返回值

|字段 |类型 |说明 |
| --- | --- | --- |
| `updated` | `boolean` |窗口服务是否接受最小化操作 |

## 行为

- Windows 调用 `ShowWindow(window, SW_MINIMIZE)`。
- Android 返回 `NOT_SUPPORTED`，能力列表不包含该命令。
- 不提供恢复、聚焦或取消最小化方法。

## 示例

```ts
const { commands } = await KSM.capabilities();

if (commands.includes('window.minimize')) {
  await KSM.window.minimize();
}
```

## 错误

|错误 |场景 |
| --- | --- |
| `PERMISSION_DENIED` | `window.control` 不可用 |
| `NOT_SUPPORTED` | Android 或宿主没有配置窗口服务 |
| `TIMEOUT` |宿主未在默认时间内响应 |

## 相关

- [maximize](/docs/kasumi/api/window/maximize)
- [window 模块](/docs/kasumi/api/window)