借助阿里云【语音服务】实现异常实时报警

2021-08-07 21:15:29

随着物联网的普及，当设备发生异常时候的通知方式也有了多种多样的实现。从传统的后台异常列表，到短信通知，到微信消息通知等。但是当设备探测到火警异常时，需要实时通知到相关人员。

下面具体介绍如何借助阿里云的【语音服务】实现。

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-sdkapi_demosingleCallByTts.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疑似火警,请您及时确认以免造成人员及财产损失】
大家也可以试听下实际的通话录音

3. 总结

通过阿里云的语音服务，帮助我们能够快速搭建异常通知系统。这里只是介绍其中最简单的一种应用，实际上还有【语音验证码】【智能外呼机器人】等功能，对于拥有自有线路的用户，还可以SIP Trunk的接入方式将语音网关与语音服务平台进行对接。
我们现在主要在以下场景进行了应用：

火警
电网设备报警
物业费用等电话催缴通知
会员服务续费到期通知

最后小小吐槽下，希望提供阿里云语音服务的运营商线路能够稳定些，不要老是进行切换。

码农公寓

1. 准备工作

2. 试试看效果

3. 总结

相关文章