机器人命令.md

September 3, 2024 · View on GitHub

命令

你可以在后台,为自己的Bot创建期望用户输入的命令,然后将命令导出

命令解析

// bot的单个命令
type Bot的单个命令 struct {
	// 命令描述,开发者输入的描述             
	Description         string   `json:"description"`
	// 命令的ID,雪花算法生成,唯一值          
	ID                  string   `json:"id"`
	// 命令名称,开发者输入的名称             
	Name                string   `json:"name"`
	// 用户输入内容                    
	Options             []Option `json:"options,omitempty"`
	// 命令类型,目前还未使用只有默认值0         
	Type                int64    `json:"type"`
}

type Option struct {
	// 用户通过选择输入          
	Choices     []Choice `json:"choices,omitempty"`
	// 解释                
	Description *string  `json:"description,omitempty"`
	// 用户输入内容            
	Name        *string  `json:"name,omitempty"`
	// 该输入是否强制要求         
	Required    *bool    `json:"required,omitempty"`
	// 用户输入类型            
	Type        *int64   `json:"type,omitempty"`
}

type Choice struct {
	// 当前选项的说明              
	Description     *string `json:"description,omitempty"`
	// 用户通过选择输入的展示名称        
	Name            *string `json:"name,omitempty"`
	// 用户通过选择输入类型           
	Type            *string `json:"type,omitempty"`
	// 用户通过选择输入的值           
	Value           *string `json:"value,omitempty"`
}

使用命令

在黑盒语音的房间中的文字频道,使用"/"唤起命令列表,选择命令输入

接收命令

在Websocket的客户端,会收到用户使用命令的推送