物联网视频服务提供的Java SDK,可帮助开发人员通过Java程序,更便捷地使用物联网视频服务提供的各种功能。本文介绍Java SDK的使用方法。

前提条件

已安装阿里云物联网平台云端SDK。详细信息,请参见阿里云物联网平台云端SDK参考
说明

安装阿里云物联网平台云端SDK后,调用QueryDeviceDetail接口可获取设备的IotId。物联网视频服务提供的部分接口,其请求参数中包含IotId。

安装SDK

  1. 安装Java开发环境。
    您可以从Java 官方网站下载,并按说明安装Java开发环境。
  2. 安装LinkVisual Java SDK。
    1. 访问Apache Maven 官网下载Maven软件。
    2. 添加Maven项目依赖。
      • 最新版LinkVisual Java SDK的Maven依赖坐标:
        <dependency>
           <groupId>com.aliyun</groupId>
           <artifactId>aliyun-java-sdk-linkvisual</artifactId>
           <version>1.5.8</version>
        </dependency>
      • 阿里云Java SDK公共包Maven依赖坐标:
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>4.5.3</version>
        </dependency>

初始化SDK

 String accessKeyID = "<your accessKey>";
 String accessKeySecret = "<your accessSecret>";
 String regionId = "cn-shanghai";
 DefaultProfile.addEndpoint(regionId, regionId, "linkvisual", "linkvisual.cn-shanghai.aliyuncs.com");
 IClientProfile profile = DefaultProfile.getProfile(regionId, accessKeyID, accessKeySecret);//初始化客户端
 client = new DefaultAcsClient(profile);
参数 说明
accessKey 您阿里云账号的AccessKey ID

您可在阿里云官网控制台AccessKey管理中创建或查看您的AccessKey。

accessSecret 您阿里云账号的AccessKey Secret
profile profile对象用于存放SDK初始化信息,其中${RegionId}是您的物联网平台服务的地域代码。

您可在物联网平台控制台左上方,查看当前服务所在地域。

地域代码的表达方法,请参见地域和可用区

发起调用

物联网视频服务云端SDK为每个API封装了一个类,命名为${API名称}+"Request",用于API的调用请求。物联网视频服务云端API,请参见API列表

本文以调用QueryLiveStreaming接口获取设备直播开播地址为例,介绍调用方法。

关于示例中request请求参数的设置,请参见对应的API文档:QueryLiveStreaming

注意 以下代码中iotInstanceId为实例ID,企业版实例填写实例ID,公共实例要删除代码request.setIotInstanceId("iotInstanceId");

购买企业版实例,并获取实例ID的方法,请参见购买企业版实例

//获取设备直播开播地址请求 
QueryLiveStreamingRequest queryLiveStreamingRequest = new QueryLiveStreamingRequest();
queryLiveStreamingRequest.setIotId(iotId);
queryLiveStreamingRequest.setScheme(scheme);
queryLiveStreamingRequest.setIotInstanceId(iotInstanceId);
queryLiveStreamingRequest.setPlayUnLimited(true);
//获取设备直播开播地址的回复
QueryLiveStreamingResponse queryLiveStreamingResponse = (QueryLiveStreamingResponse)executeSend(queryLiveStreamingRequest);
if (200 == queryLiveStreamingResponse.getCode()) {
    return queryLiveStreamingResponse.getData().getPath();
}

附录

阿里云OpenAPI开发者门户提供API在线调试工具。在API调试页面,您可以快速检索和体验调用API。系统会根据您输入的参数同步生成各语言SDK的代码示例。各语言SDK代码示例显示在页面右侧SDK示例页签下供您参考。在调用结果页签下,可查看API调用的真实请求URL和JSON格式的返回结果。