# 教程

# 一、申请开发者认证
   ## 1、申请认证
   
        开发黑盒语音机器人，需要进行开发者认证，访问。https://open.xiaoheihe.cn/zh_cn/chat_robot/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
   进入机器人开发平台。
   点击新建机器人创建您的机器人。
   ![机器人开发平台](https://imgheybox.max-c.com/oa/2024/08/29/e6e11bf1c077edab9f498686d47b09d9.png)
   
   输入您的机器人名称，并且阅读开发者服务协议进行创建。
   ![机器人开发平台](https://imgheybox.max-c.com/oa/2024/08/29/eaccaad91161dd4ea73254a97e203494.png)
   
   创建成功后，可以看到机器人的详情页面。
   ![机器人开发平台](https://imgheybox.max-c.com/oa/2024/08/29/1b5e75e1b5cb884357786e4503936145.png)
   
    
    
# 三、将机器人添加到房间
## 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、可以在此基础上实现自己的机器人功能