如何使用云端JavaSDK_物联网智能视频服务(LinkVisual)-阿里云帮助中心

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

前提条件

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

前提条件

说明

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

安装SDK

安装Java开发环境。
您可以从Java 官方网站下载，并按说明安装Java开发环境。

安装LinkVisual Java SDK。

访问Apache Maven 官网下载Maven软件。

添加Maven项目依赖。

最新版LinkVisual Java SDK的Maven依赖坐标：

<dependency>
   <groupId>com.aliyun</groupId>
   <artifactId>aliyun-java-sdk-linkvisual</artifactId>
   <version>1.5.23</version>
</dependency>

阿里云Java SDK公共包Maven依赖坐标：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.5.3</version>
</dependency>

初始化SDK

 // 阿里云账号AccessKey拥有所有API的访问权限，建议您使用RAM用户进行API访问或日常运维。
 // 强烈建议不要把AccessKey ID和AccessKey Secret保存到工程代码里，否则可能导致AccessKey泄露，威胁您账号下所有资源的安全。
 // 本示例以将AccessKey和AccessKeySecret保存在环境变量为例说明。
 String accessKeyID = System.getenv("CC_AK_ENV");
 String accessKeySecret = System.getenv("CC_SK_ENV");
 String regionId = "cn-shanghai";
 DefaultProfile.addEndpoint(regionId, regionId, "linkvisual", "linkvisual.cn-shanghai.aliyuncs.com");
 IClientProfile profile = DefaultProfile.getProfile(regionId, accessKeyID, accessKeySecret);//初始化客户端
 DefaultAcsClient client = new DefaultAcsClient(profile);

参数	说明
accessKeyID	您阿里云账号的AccessKey ID。您可在控制台AccessKey管理中创建或查看您的AccessKey。
accessKeySecret	您阿里云账号的AccessKey Secret。
profile	profile对象用于存放SDK初始化信息，其中`${RegionId}`是您的物联网平台服务的地域代码。您可在物联网平台控制台左上方，查看当前服务所在地域。

发起调用

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

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

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

重要

以下代码中iotInstanceId为实例ID，企业版实例和新版公共实例填写实例ID，旧版公共实例要删除代码queryLiveStreamingRequest.setIotInstanceId(iotInstanceId);。

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

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

附录

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