4G定向流量产品开发实践
本文介绍4G定向流量产品的对接开发指南。
背景
设备如果使用运营商4G定向流量卡上云,那么需要在运营商侧备案设备上云相关服务的域名(需要您与所使用的4G定向流量卡提供商对接沟通)。本文提供了LV标准版设备端SDK上云的服务域名及对接说明。
服务域名列表
如果运营商支持域名通配,建议配置泛域名:*.aliyuncs.com
功能 | 域名 | 协议 | 端口 |
实时直播 | iotx-vision-streaming-rtmp-vpc-sh-single-eip.aliyuncs.com | RTMP | 8000或443 |
卡录像点播 | iotx-vision-vod-rtmp-vpc-sh-single-eip.aliyuncs.com | RTMP | 8000或443 |
图片 | link-vision-picture-sh.oss-cn-shanghai.aliyuncs.com | HTTPS | 443 |
物联网基础连接 | *.mqtt.iothub.aliyuncs.com 说明 LV标准版项目对应一个企业实例,每个企业实例接入地址不同,当前可以从设备日志里查看具体的接入域名 | MQTT | 1883或443 |
OTA | ota-cn-shanghai.iot-thing.aliyuncs.com | HTTPS | 443 |
全球统一激活 | iot-auth-global.aliyuncs.com | HTTPS | 443 |
业务日志 | iotx-vision-business.cn-shanghai.log.aliyuncs.com | HTTPS | 443 |
SDK内部使用的域名解析服务
除了以上服务域名外,设备端SDK内部使用硬编码DNS服务(223.5.5.5、223.6.6.6、8.8.8.8)进行DNS解析,也需要提供给定向流量卡提供商备案加白名单。您可以采用如下两个方案之一:
把LV标准版设备端SDK内部硬编码的DNS服务IP(223.5.5.5、223.6.6.6、8.8.8.8)提供给运营商配置白名单;
与定向流量卡提供商沟通,获取推荐的DNS服务器IP,并在ali-smartliving-device-sdk-c中找到dns.c文件,修改g_dns_server_list中的IP为定向流量卡提供商推荐使用的DNS服务IP。
SDK版本要求
LV标准版设备SDK需要1.5.0及以上版本,建议获取最新发布的版本进行对接。
云端配置产品白名单
LV标准版云端给设备下发的直播、点播的推流地址默认是IP,如果为定向流量卡的场景,需要按产品ProductKey配置白名单下发对应给运营商备案过的域名。您需要联系我们的技术支持同学提供定向流量卡产品ProductKey,我们为其配置白名单。
在开发调试阶段,您可以提供调试设备证书(ProductKey、DeviceName和DeviceSecret),我们云端为调试设备配置白名单,方便您联调确认功能对接正常。在开发对接完成后,再按产品ProductKey配置域名白名单。
功能验证
确保LV标准版设备端SDK版本是1.5.0及以上,可以从设备端日志查看并确认。
提供调试设备证书(ProductKey、DeviceName、DeviceSecret)或者产品ProductKey,由我们云端配置域名功能白名单后,确定设备端下发的直播、卡录像点播是如上列表的域名。
提供如上域名列表给定向流量卡提供商配置白名单,在定向流量卡设备上确认以上域名均能Ping通,并验证设备上的云业务功能正常。