随着物联网的普及,当设备发生异常时候的通知方式也有了多种多样的实现。从传统的后台异常列表,到短信通知,到微信消息通知等。但是当设备探测到异常时,需要实时通知到相关人员。
下面具体介绍如何借助阿里云的【语音服务】实现。
1. 准备工作
1.1 登录阿里云语音服务,进行资质申请,需要准备好企业信息,法人信息以及加盖企业公章的入网承诺书、号码申请公函;
1.2 资质申请通过后,就可以购买号码了。
注1:目前只能申请企业归属地所属的号码,比如企业是在杭州的,就不能购买上海的号码段;
注2:因为阿里云接入的是移动联通电信三大运营商,号码段经常发生变化,在实际购买时可能存在号码库为空的场合,这种情况下建议下个工单给小二,催下进度;
注3:号码是按月租费计算,实际通话费用按照拨打时间进行附加收费;
1.3 准备【文本转语音模板】;
注1:模板内容和阿里云短信一样,可以自己定义替换变量;
注2:文本输入完成后,建议试听一下,计算下时长,如果超过1分钟后就按照2分钟进行收费啦;
注3:可以自己选择声音类型,这个功能瞬间点赞;
2. 试试看效果
阿里云上的配置基本做好了,接下来就是如何嵌入我们的代码啦。
2.1 重新梳理一下语音服务的流程。
2.2 整理好需要用到的阿里云参数资料。
2.2.1 $accessKeyId,$accessKeySecret(可通过https://ak-console.aliyun.com页面创建)
注:由于$accessKeyId,$accessKeySecret是阿里云全局的,比如短信,OSS等,请注意保管,必要时可以通过【创建子用户accessKey】配置权限进行使用;
2.2.2 CalledShowNumber主叫号码,即1.2中购买的号码,用于接听电话时显示;
2.2.3 CalledNumber被叫号码,仅支持中国大陆号码。根据业务需求,设定需要处理该异常消息的人员电话;
2.2.4 TtsCode模板ID,即1.3中配置好的模板ID;
2.2.5 模板中配置的参数值,比如$position(报警地址),$devicename(设备名称),$time(报警时间)
2.3 下载PHP的DEMO,另外,阿里云还支持Java,Python的地址,大家可以去试一下。
注:目前最新的语音服务新版SDK源码已经托管至开源平台Github及主流依赖仓库
2.4 打开【aliyun-dyvms-php-sdk\api_demo\singleCallByTts.php】,代入2.3中的各项参数。
ini_set("display_errors", "on");
require_once dirname(__DIR__) . '/api_sdk/vendor/autoload.php';
use Aliyun\Core\Config;
use Aliyun\Core\Profile\DefaultProfile;
use Aliyun\Core\DefaultAcsClient;
use Aliyun\Api\Dyvms\Request\V20170525\SingleCallByTtsRequest;
// 加载区域结点配置
Config::load();
/**
* 文本转语音外呼
*
* 语音服务API产品的DEMO程序,直接执行此文件即可体验语音服务产品API功能
* (只需要将AK替换成开通了云通信-语音服务产品功能的AK即可)
* 备注:Demo工程编码采用UTF-8
*/
function singleCallByTts() {
//产品名称:云通信语音服务API产品,开发者无需替换
$product = "Dyvmsapi";
//产品域名,开发者无需替换
$domain = "dyvmsapi.aliyuncs.com";
// TODO 此处需要替换成开发者自己的AK (https://ak-console.aliyun.com/)
$accessKeyId = "$2.3.1准备的accessKeyId "; // AccessKeyId
$accessKeySecret = "$2.3.1准备的accessKeySecret"; // AccessKeySecret
// 暂时不支持多Region
$region = "cn-hangzhou";
// 服务结点
$endPointName = "cn-hangzhou";
//初始化acsClient,暂不支持region化
$profile = DefaultProfile::getProfile($region, $accessKeyId, $accessKeySecret);
// 增加服务结点
DefaultProfile::addEndpoint($endPointName, $region, $product, $domain);
// 初始化AcsClient用于发起请求
$acsClient = new DefaultAcsClient($profile);
//组装请求对象-具体描述见控制台-文档部分内容
$request = new SingleCallByTtsRequest();
//必填-被叫显号
$request->setCalledShowNumber("$1.2购买的号码");
//必填-被叫号码
$request->setCalledNumber("$需要拨打的电话号码");
//必填-Tts模板Code
$request->setTtsCode("$1.3配置的模板ID");
//选填-Tts模板中的变量替换JSON,假如Tts模板中存在变量,则此处必填
$request->setTtsParam("{\"position\":\"$杭州滨江滨兴路500号\",\"devicename\":\"$烟感\",\"time\":\"$9:10\"}");
//选填-音量
$request->setVolume(100);
//选填-播放次数
$request->setPlayTimes(3);
//选填-外呼流水号
$request->setOutId("213123123");
//hint 此处可能会抛出异常,注意catch
$response = $acsClient->getAcsResponse($request);
return $response;
}
// 调用示例:
set_time_limit(0);
header("Content-Type: text/plain; charset=utf-8");
$response = singleCallByTts();
echo "文本转语音外呼(singleCallByTts)接口返回的结果:\n";
print_r($response);
2.5 执行后的页面输出如下:
文本转语音外呼(singleCallByTts)接口返回的结果:
stdClass Object
(
[Message] => OK
[RequestId] => 9F9310B3-4390-44B9-89B5-C33A907A282D
[Code] => OK
[CallId] => 118407437815^105205032815
)
2.6 耐心等待几秒钟,被拨打的电话号码就会收到一条来电,根据我们的参数配置会循环3遍提示。
【您位于杭州滨江滨兴路500号的烟感在9:10疑似出现XX情况,请您及时确认以免造成人员及财产损失】
大家也可以试听下实际的通话录音
3. 总结
通过阿里云的语音服务,帮助我们能够快速搭建异常通知系统。这里只是介绍其中最简单的一种应用,实际上还有【语音验证码】【智能外呼机器人】等功能,对于拥有自有线路的用户,还可以SIP Trunk的接入方式将语音网关与语音服务平台进行对接。
我们现在主要在以下场景进行了应用:
- 电网设备报警
- 物业费用等电话催缴通知
- 会员服务续费到期通知
最后小小吐槽下,希望提供阿里云语音服务的运营商线路能够稳定些,不要老是进行切换。