黑盒语音接口

教程

一、申请开发者认证

1、申请认证

    开发黑盒语音机器人，需要进行开发者认证，访问。https://open.xiaoheihe.cn/zh_cn/home
    
    点击立即使用申请认证。
    ![](https://imgheybox.max-c.com/oa/2024/08/29/8d468e542d42b627b0e2f135b8c7fda0.png)
    
    输入认证所需要的信息。
    ![机器人开发平台](https://imgheybox.max-c.com/oa/2024/08/29/43fac4780eb099777eeff82ea1264a2c.png)
    
    填写完成后，官方工作人员会在3个工作日内处理。
    ![](https://imgheybox.max-c.com/oa/2024/08/29/543529480a29615989824cedca79ff6c.png)

二、创建机器人

1、创建机器人

在申请开发者认证成功后，访问https://bot.xiaoheihe.cn
进入机器人开发平台。
点击新建机器人创建您的机器人。

输入您的机器人名称，并且阅读开发者服务协议进行创建。
机器人开发平台

创建成功后，可以看到机器人的详情页面。
机器人开发平台

三、将机器人添加到房间

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

目前机器人已经默认添加了查看频道和发送消息的权限，没有此权限的话，机器人无法在房间发送消息。
![](https://imgheybox.max-c.com/oa/2024/08/29/4b5ce650b4bd98f2ca4cad3d7c3693f6.png)

2、复制邀请链接

在机器人详情中，点击邀请链接，复制到浏览器中。
![](https://imgheybox.max-c.com/oa/2024/08/29/ac8068e71b1815e94ae6f05bdae9230e.png)

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

然后将该机器人添加到管理的房间中。
![](https://imgheybox.max-c.com/oa/2024/08/29/374631b5b7ec8e495d92dc24fde94ebf.png)

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

1、实现复读机功能

此功能可以通过用户输入命令后，机器人可以复读输出用户输入的内容。
![](https://imgheybox.max-c.com/oa/2024/08/29/09d1ebd46716f539e5e9875ab1c21977.png)

点击导出JSON，可以导出刚才自己输入的内容。
![](https://imgheybox.max-c.com/oa/2024/08/29/fc4a41bb408f1e73038d29804fa80dbd.png)

2、使用官方Demo

项目地址https://github.com/QingFengOpen/HeychatDemo

目前只提供了Python和Golang的Demo，其他语言的Demo在陆续开发中。
以为Python为例，将机器人详情页面的token复制到此位置。
![](https://imgheybox.max-c.com/oa/2024/08/29/975ae600525d90b69f84d489ea56d6b4.png)

这段代码的意思是在收到id 为"1829106497992212480"的命令后后，将用户输入的值，输出到指定的房间的频道里面。
![](https://imgheybox.max-c.com/oa/2024/08/29/b1c5cdb68e733255d989fff77a36dc4f.png)

启动python项目，进入邀请到机器人的房间中，在输入框使用"/"，呼出房间的机器人命令。
![](https://imgheybox.max-c.com/oa/2024/08/29/2dc71e03e2d87c84f48e7d0a6a0c36de.png)

使用该命令，机器人将我们输入的内容给复读回来了。
![](https://imgheybox.max-c.com/oa/2024/08/29/ce8159ddcd117c3e80316f15ae8d61a1.png)

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

[updatedIn] 4 个月前