# entity.player.dialog

:::warning
该 API 文档：[dialog](https://docs.dao3.fun/api/GamePlayerEntity/chat.html#dialog)
:::

:::tip
**修改原因：**  
由于官方原先提供的 d.ts 文件中，该 API 的接口定义与 TypeScript 的编码标准不匹配，导致许多创作者使用上的困难，我们进行了必要的优化调整。
:::

## 功能分类

### 对话框类型

- **文本对话框**：显示纯文本信息
- **选项对话框**：提供多个选项供用户选择
- **输入对话框**：允许用户输入文本

## 使用示例

### 文本对话框

![](/text.webp)

### 选项对话框

![](/select.webp)

### 输入对话框

![](/input.webp)

## 优势与特点

1. **类型安全**：通过定义明确的类型，TypeScript 能够在编译时捕获潜在的错误，比如传递了错误类型的参数或遗漏了必需的属性。

2. **清晰的 API 文档**：类型定义本身就是一种文档，它清楚地说明了每个 API 调用需要什么参数以及这些参数的类型。

3. **增强的代码可读性**：当其他创作者阅读你的代码时，类型定义提供了额外的上下文，使他们更容易理解你的意图。

4. **减少运行时错误**：通过静态类型检查，你可以在代码运行之前捕获许多常见的错误，从而减少运行时出现问题的可能性。

## 最佳实践

- 合理使用对话框类型，确保用户交互体验
- 保持对话框内容的简洁性和易读性
- 注意对话框的视觉设计，确保与游戏整体风格一致
