Linux平台:Alexa语音服务快速入门指南

最新推荐文章于 2024-02-23 15:44:12 发布
最新推荐文章于 2024-02-23 15:44:12 发布
阅读量6.8k 收藏 10
点赞数 1
分类专栏： 【工作项目积累】

原文地址
译者：远方的自由
转载请注明出处: http://blog.csdn.net/z2066411585

概述

  • 用于C++的AVS设备SDK为Alexa语音服务提供了一个现代化的C++(11或更高版本)接口,允许开发人员将智能语音控制添加到连接的产品中.它是模块化和抽象的,提供组件去处理离散功能,例如语音捕获,音频处理和通讯,
    　每个组件都开放API允许你使用和定制.它还包含一个示例应用程序,演示与AVS的互动。
    　
  • 快速设置你的树莓派开发环境和学习如何优化libcurl的大小,参见wiki或click here

列表

  • 通用条款
  • 最低要求和依赖环境
  • 前提
  • 创建源代码外部构建
  • 运行AuthServer
  • 运行单元测试
  • 运行集成测试
  • 运行示例代码
  • 安装SDK
  • 用于C++ API 文档的AVS设备SDK
  • 资源与指导
  • 发行说明

通用条款

  • 界面 - 语音识别，音频回放和音量控制等与客户端功能对应的称为指令和事件的逻辑分组消息,
  • 指令 - AVS发送消息通知你的设备做相应的动作
  • 事件 - 你的设备发送消息通知AVS发生了一些事情
  • 下行通道 - 你在HTTP/2连接中创建的流,用于将指令从AVS传递到你的设备.设备的半关闭状态下,下行通道保持打开的状态,并在整个连接过程中从AVS打开,下行通道主要用于将云端的指令发送到你的设备
  • 云端指令 - 从AVS发送指令到你的产品,例如,当一个用户从App调节音量,一个指令发送到你的产品,并没有相应的语音请求

最低要求和依赖关系

核心依赖

媒体播放器依赖关系

构建MediaPlayerInterface 参考实现是可选的，但是要求:

注意: 插件可能依赖于需要基于GStreame的MediaPlayer安装的库,才能正常工作

示例应用依赖关系

构建示例应用是可选的,但是要求：

  • PortAudio v190600_20161030
  • GStreamer

注意: 示例应用程序将使用或禁止唤醒词,如果在没有唤醒词的情况下构建,则示例程序将禁用免提模式

音乐提供之的依赖关系

iHeartRadio播放器需要一下解码器和安装包

  • GStreamer Bad Plugins 1.10.4 或更新
  • 分流器的 Crypto Libary
  • GStreamer 使用的HTTP 客户端和服务器库：libsoup
  • AAC和HE-AAC解码: libfaad-dev

准备

在创建构建之前,你需要安装运行AuthServer所需要的一些软件,AuthServer是使用Flask在Python中构建最小的授权服务器. 它提供一种简单的方式来获取你的第一个刷新令牌,这将用于集成测试
并获取所有与AVS交互所需要的访问令牌

重要提示 : AuthServer仅用于测试目的,商业产品将使用亚马逊开发者门户上提供用于远程授权和本地授权的指令获得使用亚马逊(LWA)证书的登录,有关其他信息,参见AVS Authorization

第一步:安装pip

如果你的系统上没有安装pip,遵循详细的安装说明:链接

第二步:安装flash和requests

对于Windows运行这个命令

pip install flash requests

对于Unix/Mac运行这个命令

pip install –user flash requests

第三步:获取你的产品ID,Cliend ID, 和客户端秘钥

如果你还没有,按照这些说明注册产品和创建一个安全配置文件

确保注意以下内容,稍后配置AuthServer需要用到以下内容

  • 产品ID
  • 客户端ID
  • 客户端秘钥

重要提示：确保你在网页选项卡中设置了允许来源和允许返回URL

创建一个外部构建

以下说明假定满足所有要求和依赖关系,并已经克隆仓库(或保存本地压缩包)

CMake 构建类型和选项

支持以下构建类型:

  • DEBUG - 用-g编译标志位显示调试日志
  • RELEASSE - 添加-O2标志并删除-g标志
  • MINSIZEREL - RELEASE标志位编译并用( -O s)优化为编译最小体积的版本

指定构建类型,使用这个命令代替下面的步骤4：

cmake <absolute-path-to-source> -DCMAKE_BUILD_TYPE=<build-type>`

构建一个唤醒词

注意:唤醒词检测和关键字检测可互换使用

用于C++的AVS Device SDK支持来自Sensory和KITT.ai唤醒词检测.
构建唤醒词检测需要以下选项: 请用Sensory的SENSORY替换<wake-word-name>和KITT.ai的KITTAI:

  • -D<wake-word-name>_KEY_WORD_DETECTOR=<ON or OFF> -指定在构建期间唤醒词启用还是禁用
  • -D<wake-word-name>_KEY_WORD_DETECTOR_LIB_PATH=<absolute-path-to-lib> - 唤醒词库的路径
  • -D<wake-word-name>_KEY_WORD_DETECTOR_INCLUDE_DIR=<absolute-path-to-include-dir> - 唤醒词头文件目录的路径

注意: 要列出所有可用的 CMake选项,使用以下命令:-LH

Sensory

如果使用Sensory唤醒词,版本要求5.0.0-beta.10.2 或更高版本

这是一个cmake命令构建Sensory的例子


cmake <absolute-path-to-source> -DSENSORY_KEY_WORD_DETECTOR=ON -DSENSORY_KEY_WORD_DETECTOR_LIB_PATH=.../alexa-rpi/lib/libsnsr.a -DSENSORY_KEY_WORD_DETECTOR_INCLUDE_DIR=.../alexa-rpi/include

请注意,在运行cmake并将其构建到SDK之前,你可能需要授权Sensory库,可以在Sensory Github页面下发现一个授权Sensory库的脚本bin/license.sh

KITT.ai

一个矩阵计算库,被称为BLAS,需要使用KITT.ai,以下是安装此库的示例命令:

  • 通用 Linux : apt-get install libatlas-base-dev
  • macOS : brew install homebrew/science/openblas

这是一个cmake命令构建KITT.ai的例子：


cmake <absolute-path-to-source> -DKITTAI_KEY_WORD_DETECTOR=ON -DKITTAI_KEY_WORD_DETECTOR_LIB_PATH=.../snowboy-1.2.0/lib/libsnowboy-detect.a -DKITTAI_KEY_WORD_DETECTOR_INCLUDE_DIR=.../snowboy-1.2.0/include

MediaPlayer实现的构建

MediaPlayer(MediaPlayerInterface的参考实现)基于GStreamer,并不是默认生成,要构建MediaPlayer必须CMake指定-DGSTREAMER_MEDIA_PLAYER=ON选项

如果GStreamer通过源码安装,构建的时候必须CMake通过DCMAKE_PREFIX_PATH选项指定前缀路径

这是一个cmake命令的例子

cmake <absolute-path-to-source> -DGSTREAMER_MEDIA_PLAYER=ON -DCMAKE_PREFIX_PATH=<path-to-GStreamer-build>

构建PortAudio(运行示例程序所需)

PortAudio是运行C++示例程序的AVS设备SDK必须的,构建说明可用于Linux和macOS

这是使用PortAudio为C++构建AVS Device SDK 的示例CMake命令:

cmake <absolute-path-to-source> -DPORTAUDIO=ON
-DPORTAUDIO_LIB_PATH=<path-to-portaudio-lib>
-DPORTAUDIO_INCLUDE_DIR=<path-to-portaudio-include-dir>

例子:

cmake <absolute-path-to-source> -DPORTAUDIO=ON
-DPORTAUDIO_LIB_PATH=.../portaudio/lib/.libs/libportaudio.a
-DPORTAUDIO_INCLUDE_DIR=.../portaudio/include

通用的Linux/macOS构建

创建一个外部构建:

1.克隆一个仓库(或下载解压该压缩包)

2.创建一个外部编译目录. 重要:这个目录不能是源目录的子目录

3.cd你的编译目录

4.在你的编译目录,运行cmake,你应该看到下面的消息: 

-- Please fill <absolute-path-to-build-directory>/Integration/AlexaClientSDKConfig.json before you execute integration tests.

打开Integration/AlexaClientSDKConfig.json用你最喜欢的文本编辑器填写你的产品信息

5.从编译目录,运行make编译SDK

应用程序设置

SDK需要配置json文件,其中一个例子在Integration/AlexaClientSDKConfig.json.json的内容应该填入你的产品信息(你在注册产品和创建安全配置文件从开发人员门户获得),和数据库和声音的位置.这个json文件
是集成测试正常工作必须的,也适用于示例应用程序

该文件的格式如下:

{
    "authDelegate":{
        "clientSecret":"<Client Secret for your device from the Amazon Developer Portal>",
        "deviceSerialNumber":"<A unique value that you create, similar to a SKU or UPC. E.g. "123456">",
        "refreshToken":"${SDK_CONFIG_REFRESH_TOKEN}",
        "clientId":"<Client ID for your device from the Amazon Developer Portal>",
        "productId":"<Product ID for your device from the Amazon Developer Portal>"
     },

   "alertsCapabilityAgent":{
        "databaseFilePath":"/<absolute-path-to-db-directory>/<db-file-name>",
        "alarmSoundFilePath":"/<absolute-path-to-alarm-sound>/alarm_normal.mp3",
        "alarmShortSoundFilePath":"/<absolute-path-to-short-alarm-sound>/alarm_short.wav",
        "timerSoundFilePath":"/<absolute-path-to-timer-sound>/timer_normal.mp3",
        "timerShortSoundFilePath":"/<absolute-path-to-short-timer-sound>/timer_short.wav"
   },

   "settings":{
        "databaseFilePath":"/<absolute-path-to-db-directory>/<db-file-name>",
        "defaultAVSClientSettings":{
            "locale":"en-US"
          }
    },
   "certifiedSender":{
        "databaseFilePath":"/<absolute-path-to-db-directory>/<db-file-name>"
    }
 }

注意:deviceSerialNumber是你创建的唯一标识符,它不是亚马逊提供的.注意:根据Alexa Voice Service Agreement
包含在仓库库中的音频资料被授权”Alexa Materials”

运行AuthServer

在创建外部构建目录之后,下一步是运行AuthServer从LWA中获取有效的刷新令牌

  • 运行这个命令启动AuthServer:

python AuthServer/AuthServer.py

你应该看到一条指示服务器正在运行的消息

  • 打开你最喜欢的浏览器并跳转到　http://localhost:3000
  • 按照屏幕上的说明进行操作
  • 输入你的凭证后,服务器应该自行终止,Integration/AlexaClientSDKConfig.json中将会填充刷新令牌,在你继续之前,Integration/AlexaClientSDKConfig.json中确保有刷新令牌是重要的

运行单元测试

用于C++的AVS Device SDK单元测试使用Google Test框架,确保已经安装Google Test,然后运行make all test

开始集成测试之前,确保所有单元测试都已经通过

运行Sensory使能单元测试

为了运行Sensory唤醒次检测单元测试,你必须从GitHub下载以下文件并存放在<source dir>/KWD/inputs/SensoryModels确保集成测试正常运行

运行KITT.ai使能单元测试

为了运行KITT.ai唤醒次检测单元测试,你必须从GitHub下载以下文件并存放在<source dir>/KWD/inputs/KittAiModels:

  • common.res
  • alexa.umdl - 为了KITT.ai集成测试的正常工作,下载resources/alexa/alexa-avs-sample-app中的alexa.umdl是重要的

运行集成测试

集成测试确保你的构建可以从AVS提出请求和接收响应

  • 所有AVS的请求都需要授权凭证
  • 警报的集成测试需要你的系统是UTC时间

重要:集成测试参考AlexaClientSDKConfig.json文件，你必须创建它,如果你没有完成此操作,参见Create the AlexaClientSDKConfig.json file部分(上面)
运行集成测试使用这个命令:Create the AlexaClientSDKConfig.json file

网络集成测试

如果你的项目是基于GNU/Linux平台(Ubuntu,Debian等)构建的,有一个可选的的集成测试,用于测试慢速网络的ACL(Access Control List: 是路由器和交换机接口的指令列表,用来控制端口进出的数据包),启用这个测试,使用
CMake这个选项

cmake <absolute-path-to-source> -DNETWORK_INTEGRATION_TESTS=ON –DNETWORK_INTERFACE=eth0

注意:网络接口的名称可以使用ifconfig -a查看

重要:这个测试需要root权限.

运行集成测试并使能Sensory

如果该项目是用Sensory唤醒词构建,你必须从GitHub下载以下文件并放在<source dir>/Integration/inputs/SensoryModels保证集成测试正常运行:

运行集成测试并使能KITT.ai

如果该项目是用KITT.ai唤醒构建,你必须从Github下载以下文件并放在<source dir>/Integration/inputs/KittAiModels保证集成测试的正常运行：

  • common.res
  • alexa.umdl - 请务必下载资源resources/alexa/alexa-avs-sample-app中的alexa.umdl,确保KITT.ai集成测试的正常运行

运行示例程序

注意: 需要使用PortAudio和GStreamer进行构建

在运行示例程序之前,请注意应用程序需要的两个参数,第一个是必须的,并且是AlexaClientSDKConfig.json的路径,第二个是只有在构建具有唤醒词支持的示例程序才需要,并且是包含唤醒词模型的文件夹路径.

从你的构建目录跳转到SampleApp/src目录,运行这个命令:

TZ=UTC ./SampleApp <REQUIRED-absolute-path-to-config-json> <OPTIONAL-absolute-path-to-wake-word-engine-folder-enclosing-model-files> <OPTIONAL-log-level>

注意: 支持以下日志记录级别,提供最高和最低的日志记录级别: DEBUG9, DEBUG8, DEBUG7, DEBUG6, DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, DEBUG0, INFO, WARN, ERROR, and CRITICAL

重要:启动示例应用程序后,你必须等待几秒钟才能加载应用程序,然后再进行第一次请求,这是一个已知问题,将在以后的版本解决.

安装AVS Device SDK

这些说明假定你已经按照说明创建了外部构建目录,运行cmake命令,你必须使用DCMAKE_INSTALL_PREFIX选型指定安装路径.

CMake的示例命令:

cmake <absolute-path-to-source>
-DCMAKE_INSTALL_PREFIX=<absolute-path-to-out-of-source-build>

运行cmake之后,运行make install安装这个SDK

库和头文件将被安装到指定的目录,另外,生成AlexaClientSDK.pc,可以在支持pkg-config.系统上使用

使用SDK构建应用程序,必须为CMake制定安装的前缀路径,例如：

cmake -DCMAKE_PREFIX_PATH=<absolute-path-to-install>

注意:你可能需要指定rpath将SDK链接到你的应用程序
注意:在你的应用程序,需要将包含路径添加到RapidJSON

用于C++API文档的AVS Device SDK

本地构建API文档,从构建目录运行这个命令:make doc.

资源和指南

程序手艺人
关注
  • 1
    点赞
  • 踩
  • 10
    收藏
    觉得还不错? 一键收藏
  • 15
    评论
专栏目录
linux 休眠定时唤醒_语音交互：从语音唤醒（KWS）聊起
weixin_39724469的博客
11-24 548
编辑导语：随着手机的逐渐智能化，越来越多的手机只要听到指令就会帮助主人完成一些任务，这就是语音唤醒功能。本文作者围绕语音唤醒功能，从其应用有哪些、工作原理是什么、怎样训练一个唤醒模型、如何测试等方面展开了详细地讨论。“Hi siri”、“天猫精灵”、“小爱同学”，我们生活中常常会叫到这些名字，让她们来帮我们完成一些指令，这个过程就像叫某人帮你做某事的感觉。而这个叫名字的过程，就是我们今天要聊的语音...
Alexa SDK庖丁解牛-第一回：主程序结构
yudongsia的专栏
01-23 2872
第一回：init()剖析 main()主程序分为以下两个部分：  1）auto sampleApplication = alexaClientSDK::sampleApp::SampleApplication::create(pathToConfig, pathToInputFolder, logLevel);  2）sampleApplication->run(); 本章只介绍相关的初
ububtu 平台 AVS搭建
Venus 的博客
05-08 4970
原文： Ubuntu Linux Quick Start Guide 1、在Ubuntu 使用AVS SDK 搭建 Alexa 2、创建安全配置文件 3、在ubuntu 上配置相关环境 1、在Ubuntu 使用AVS SDK 搭建 Alexa 调用Alexa SDK ，在ubuntu 上模拟Alexa 2、创建安全配置文件 1)登录亚马逊 2）然后按照下...
简单学习语音唤醒
最新发布
weixin_73690807的博客
02-23 907
学习，共勉！
Alexa-Voice-Service-API:Alexa语音服务V2 API，可使用流媒体和HTTP2
05-11
Alexa语音服务API Alexa语音服务V2 API，可用于流式传输和HTTP / 2 用 :sparkling_heart: 通过多兰
alexa/alexa-avs-sample-app
10-22
alexa/alexa-avs-sample-app 一个对接亚马逊Alexa的示例Demo
alexa-tello:Alexa语音控制Tello无人机
04-29
亚历山德拉·泰洛 仅使用语音与DJI / Ryze Tello互动。 该无人机与亚马逊的Alexa语音助手配合使用，以响应语音提示的命令。 将您的口头命令告诉Amazon Echo以控制您的无人机。 首先，Alexa Skills Kit解析语音命令，然后Node-RED通过MQTT将命令发送到RPi。 最后，node.js RPi将通过Tello Wifi网络将特定命令发送至无人机。 更多细节 此代码基于Tello SDK文档。 为了简化声音交互，每个动作固定在1米处，旋转固定在90度，并且仅向前翻转。 您可以在找到更多详细信息
Linux语音助手——Lewis小精灵（简陋版小度小度）
ladykiller21的博客
07-11 3460
最近看一个综艺《向往的生活》被百度的产品小精灵小度所吸引，春招的时候百度来线下宣讲我怎么没举手回答问题拿到这等福利，失手了失手了。本人之前做过一个基于网络通信的Linux聊天室，可能因为做的太挫了，也没人和我用，受这个激发在百度上搜了搜居然可以用小度的文本识别的接口，又找了个语音识别的接口且当自娱自乐就完成了下面这个对话语音小精灵（总算是有人和我聊天了），等有空了接到聊天室里看看好使不。 GIT...
Alexa交叉编译（avs-device-sdk）
qq_38731735的博客
01-13 2494
Alexa交叉编译（avs-device-sdk）编译portaudio编译curl编译gstreamer-1.1编译gstreamer-1.2编译gstreamer-1.3编译gstreamer-1.4报错libgstbase-1.0.so.0 nofind编译orc-0.4.26编译gst-plugins-base报错../gst-libs/gst/audio/.libs/libgstaudio-1.0.so: undefined编译sqlite3编译openssl终端设置英文添加gstreamer安装
avs解码器源码公开&评测
李世平的专栏
03-26 7800
【1】avs解码器avs解码器源码及测试序列下载地址：http://cosoft.org.cn/projects/avsdec也可到本站的download板块->非开放标准页面下载源码。http://lspbeyond.go1.icpcn.com/downloads.htm＝＝＝【2】简单评测提供的测试序列是《精武家庭》中的一个片断。分辨率640x280左右？，文件大小45MB
Alexa:亚马逊Alexa语音服务
05-19
亚历克斯 亚马逊Alexa语音服务
alexa_avs对接
02-02
本代码涉及alexa_avs对接android样例,使用android studio，可以用
avs-device-sdk:适用于商业设备制造商的SDK，可将Alexa直接集成到连接的产品中
04-30
什么是Alexa语音服务（AVS）？ Alexa语音服务（AVS）使开发人员可以将Alexa直接集成到其产品中，从而为任何连接的设备带来语音控制的便利。 AVS使开发人员可以访问一套资源来构建支持Alexa的产品，包括API，硬件开发套件，软件开发套件和文档。 什么是AVS Device SDK Alexa语音服务（AVS）设备SDK为您提供了一组C ++库，以构建Alexa内置产品，这意味着您的设备可以直接访问基于云的Alexa功能，以立即接收语音响应。 您的设备几乎可以是任何东西-智能手表，扬声器，耳机-随您选择。 发行说明和已知问题 上提供了所有版本的功能增强，更新和已解决的问题。 开始使用 您可以在以下平台上设置SDK： SDK架构 SDK是模块化和抽象的。 它提供了来处理必需的Alexa功能，包括处理音频，维护持久连接和管理Alexa交互。 每个组件均公开以根据需要自定义设备
alexa:alexa语音自动化测试平台
04-30
Alexa Auto Test 功能概述 采用HTML5、CSS3、JavaScript(jQuery)、PHP，实现Alexa语音自动化测试脚本，响应式布局，移动端&PC端布局兼容性优化 依赖扩展库mbstring、curl、fileinfo text to speech实现 循环播报实现(单曲，列表，随机三种模式) local command语音测试实现(单曲，列表，随机三种模式) 自定义增加语音列表 语音接口：webSpeechAPI、IBM、百度 百度语音token失效，自动更新代码实现 开发目的 降低Alexa F4项目功能测试人工负载，实现自动化/半自动化语音测试 循环播放指令主要实现代码 选中当前的语句（也可以import导入本地文件），睡眠时间(可自定义)，选择模式（单曲，循环，随机） 参数选好后，点击开始播放即可 //单曲循环 function singleLoop()
Alexa demo for ubuntu
12-23
通过libcurl实现的Alexa技术，并在Ubuntu下运行测试，功能等同Amazon Echo，并可以执行自己的SKILLS。文件中包含image下载种子链接
AVSExample-Swift:使用Swift的Alexa语音服务示例
05-08
如果您遵循上面的AVS入门指南，则将在“选择或创建安全配置文件”部分中设置ClientId ，将“产品ID”称为“设备类型ID”，并在“设备类型信息”部分中进行设置，并且DeviceSerialNumber可以是任意长度因为它
SIP协议/框架
热门推荐
hanyingzhong的专栏
12-01 1万+
Service Creation Environment (SCE ) for SIPApplications I hoped of making a SIP application Development environment a year back and worked towards it earnestly . Sadly I wasn’t able to complete the job yet I have decided to share a few things about it he.
arm linux 语音唤醒,arm linux 语音采集和播放程序 Input/output error 问题
weixin_39951930的博客
05-13 817
在arm9 linux 系统下，写简单的 语音采集和播放程序 遇到问题：步骤1.将/dev/dsp 以O_RDWR 和 同步方式打开，设置采样频率8000，双通道，16位2.在循环中read 160字节，接着write刚读到的160字节。问题这段代码在Linux - pc上，编译运行是正常的，但是在arm上，刚开始几个周期是正确的，后来read就返回错误 错误码为5 -Input/output ...
帮我写一份有关Alexa语音助手性能的测试用例
06-10
**测试目的：** 测试Alexa语音助手的性能表现，包括语音识别、语音合成、对话管理等方面。 **测试环境：** - Alexa语音助手 - 智能音箱、智能手表、智能手机等设备 - 无线网络 **测试内容：** 1. 语音识别性能...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 15
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值