Objective-C 语音通知接口集成到 iOS 应用

接入概览

互亿无线语音通知接口采用 HTTPS 协议，iOS 应用用系统原生的 NSURLSession 即可直接调用。发送接口地址为 https://api.ihuyi.com/voice/vm ，支持 POST 与 GET，返回 JSON。接口采用 API ID 加 API Key 双重认证，配合 HTTPS 加密传输。官方提供 11 种语言示例。

Objective-C 调用示例

下面用 NSURLSession 向语音接口提交一次外呼，account 为 API ID，password 为 API Key，mobile 为目标手机号，content 为播报文本。

NSURL *u=[NSURL URLWithString:@"https://api.ihuyi.com/voice/vm"];
NSMutableURLRequest *r=[NSMutableURLRequest requestWithURL:u];
r.HTTPMethod=@"POST";
r.HTTPBody=[@"account=ID&password=KEY&mobile=13800138000&content=验证码123456"
 dataUsingEncoding:NSUTF8StringEncoding];
[[[NSURLSession sharedSession] dataTaskWithRequest:r
 completionHandler:^(NSData*d,NSURLResponse*res,NSError*e){/*解析*/}] resume];

关键说明

接口返回 JSON，例如 {"code":2,"msg":"提交成功"}，code 等于 2 表示任务已提交到外呼队列，并不代表用户已接听。

• 建议把 API Key 放在应用自身服务端中转，避免在客户端硬编码泄露。
• content 支持 TTS 文本转语音，单条建议约 70 字，对应约 20 秒播报。
• 提交后接口立即返回，外呼由平台异步完成，无需主线程等待。

完整示例见 https://www.ihuyi.com/doc/voice/vm/demo 。