一、SDK 功能简介
语音消息 SDK 支持以下操作:
·发送语音验证码
·指定模板发送语音通知
注意:说明:
二、相关资料
各个接口及其参数的详情介绍请参见 API 指南 、SDK 文档 和 错误码。
三、前提条件
在使用 SDK 前,你需要准备以下信息:
·获取 SDK AppID 和 App Key
语音消息应用 SDK AppID 和 App Key 可在 语音消息控制台 的应用信息里获取。如你尚未添加应用,请登录语音消息控制台 创建应用。
·申请模板并确认审核通过
语音正文内容模板需申请和审核,模板可在 语音消息控制台 的【应用管理】>【语音模板】页面申请,详细申请操作请参见 配置语音模板。
四、配置 SDK
·nuget:
要使用 qcloudsms_csharp 功能,只需要在 .nuspec 文件中添加如下依赖:
<dependencies><dependency id="qcloud.qcloudsms_csharp" version="0.1.5" /></dependencies>
或参考 nuget 网站 进行安装。
·命令行
·Package Manager
Install-Package qcloud.qcloudsms_csharp -Version 0.1.5
·.NET CLI
dotnet add package qcloud.qcloudsms_csharp –version 0.1.5
·Paket CLI
paket add qcloud.qcloudsms_csharp –version 0.1.5
五、示例代码
注意:说明:
注意:所有示例代码仅作参考,无法直接编译和运行,需根据实际情况进行修改。
·准备必要参数
// 语音消息应用 SDK AppIDint appid = 122333333;// 语音消息应用 App Keystring appkey = "9ff91d87c2cd7cd0ea762f141975d1df37481d48700d70ac37470aefc60f9bad";// 需要发送语音消息的手机号码string[] phoneNumbers = {"21212313123", "12345678902", "12345678903"};// 语音模板 ID,需要在语音消息控制台中申请int templateId = 7839; // NOTE: 这里的模板 ID`7839`只是示例,真实的模板 ID 需要在语音消息控制台中申请
·发送语音验证码
using qcloudsms_csharp;using qcloudsms_csharp.json;using qcloudsms_csharp.httpclient;using System;try{ SmsVoiceVerifyCodeSender vvcsender = new SmsVoiceVerifyCodeSender(appid, appkey); var result = vvcsender.send("86", phoneNumbers[0], "09876", 2, ""); Console.WriteLine(result);}catch (JSONException e){ Console.WriteLine(e);}catch (HTTPException e){ Console.WriteLine(e);}catch (Exception e){ Console.WriteLine(e);}
·指定模板发送语音通知
using qcloudsms_csharp;using qcloudsms_csharp.json;using qcloudsms_csharp.httpclient;using System;try{ int templateId = 45221; string[] parameters = { "5678" }; TtsVoiceSender tvsender = new TtsVoiceSender(appid, appkey); TtsVoiceSenderResult result = tvsender.send("86", phoneNumbers[0], templateId, parameters, 2, ""); Console.WriteLine(result);}catch (JSONException e){ Console.WriteLine(e);}catch (HTTPException e){ Console.WriteLine(e);}catch (Exception e){ Console.WriteLine(e);}