黑盒语音接口
    黑盒语音接口
    • 教程
    • 开发者服务协议
    • 使用交流
    • 更新日志
    • 开发计划
    • 资源
      • 请求速率限制
      • Websocket
      • Bot命令
    • WEBSOCKET 连接请求
      • 连接到黑盒语音服务
    • HTTP接口
      • 消息接口
        • 发送消息接口的参数
        • 发送消息接口的返回值
        • 发送图片形式的频道消息
        • 发送Markdown文档
        • 更新指定频道消息
        • 删除指定的频道消息
        • 对某条频道消息增加/取消回应(小表情)
        • 发送卡片消息
        • 给用户发送私聊消息
        • 发送频道图片消息
        • 发送频道消息
        • 发送卡片消息
        • 发送频道消息@全体成员/@在线成员
        • 更新指定的频道消息
        • 删除指定的频道消息
        • 对某条频道消息增加/取消回应(小表情)
        • 给用户发送私聊消息
      • 媒体文件上传
        • 上传媒体文件的参数解析
        • 上传媒体文件
      • 房间角色接口
        • 权限相关说明
        • 接口说明
        • 获取房间角色列表
        • 创建角色
        • 更新角色
        • 删除角色
        • 对指定用户授予指定权限
        • 对指定用户剥夺指定权限
      • 房间表情
        • 房间表情包
        • 获取房间上传的表情包
        • 房间删除表情包
        • 房间更新表情包名称
      • 房间接口
        • 房间相关接口文档
        • 修改房间内昵称
        • 分页获取加入的房间列表
        • 获取房间信息
        • 退出房间
        • 房间踢人
        • 获取房间用户列表
    • 服务端推送事件
      • 事件说明
      • 通用推送字段
      • 机器人命令
        • 用户使用Bot命令
      • 频道消息事件
        • 频道消息事件
      • 房间消息事件
        • 房间消息事件

    教程

    一、申请开发者认证#

    1、申请认证#

    开发黑盒语音机器人,需要进行开发者认证,访问。https://open.xiaoheihe.cn/zh_cn/home
    点击立即使用申请认证。
    输入认证所需要的信息。
    机器人开发平台
    填写完成后,官方工作人员会在3个工作日内处理。

    二、创建机器人#

    1、创建机器人#

    在申请开发者认证成功后,访问https://bot.xiaoheihe.cn
    进入机器人开发平台。
    点击新建机器人创建您的机器人。
    机器人开发平台
    输入您的机器人名称,并且阅读开发者服务协议进行创建。
    机器人开发平台
    创建成功后,可以看到机器人的详情页面。
    机器人开发平台

    三、将机器人添加到房间#

    1、给机器人增加需要的权限#

    目前机器人已经默认添加了查看频道和发送消息的权限,没有此权限的话,机器人无法在房间发送消息。

    2、复制邀请链接#

    在机器人详情中,点击邀请链接,复制到浏览器中。

    3、将机器人添加到房间中#

    然后将该机器人添加到管理的房间中。

    四、利用命令实现机器人功能#

    1、实现复读机功能#

    此功能可以通过用户输入命令后,机器人可以复读输出用户输入的内容。
    点击导出JSON,可以导出刚才自己输入的内容。

    2、使用官方Demo#

    项目地址https://github.com/QingFengOpen/HeychatDemo
    目前只提供了Python和Golang的Demo,其他语言的Demo在陆续开发中。
    以为Python为例,将机器人详情页面的token复制到此位置。
    这段代码的意思是在收到id 为"1829106497992212480"的命令后后,将用户输入的值,输出到指定的房间的频道里面。
    启动python项目,进入邀请到机器人的房间中,在输入框使用"/",呼出房间的机器人命令。
    使用该命令,机器人将我们输入的内容给复读回来了。

    3、可以在此基础上实现自己的机器人功能#

    修改于 2024-09-03 09:34:19
    下一页
    开发者服务协议
    Built with