阅读374 返回首页    go 阿里云 go 技术社区[云栖]

调用示例__调用方式_API使用手册_视频点播-阿里云

对视频点播服务接口的调用是通过向视频点播服务端发送HTTP请求（可以通过HTTP或HTTPS通道发送），并获取视频点播服务对该请求响应结果的过程。视频点播服务端在接收到用户请求后，对请求做必要的身份验证和参数验证，在所有验证成功后根据请求的指定参数提交或完成相应操作，并把处理的结果以HTTP响应的形式返回给调用者。以下Java示例代码演示了如何添加公共请求参数、如何构造用请求参数构造规范化请求字符串，以及如何构造stringToSign字符串。示例假定所有请求参数放在一个Map对象里，使用的 Access Key ID是”testId”。,>

  1.     final String HTTP_METHOD = "GET";
  2.     Map<String, String> parameterMap = new HashMap<String, String>();
  4.     // 加入请求公共参数
  5.     parameterMap.put("Action", "QueryMediaList");
  6.     parameterMap.put("Version", "2014-06-18");
  7.     parameterMap.put("AccessKeyId", "testId"); //此处请替换成您自己的AccessKeyId
  8.     parameterMap.put("Timestamp", formatIso8601Date(new Date())); 
  9.     parameterMap.put("SignatureMethod", "HMAC-SHA1");
  10.     parameterMap.put("SignatureVersion", "1.0");
  11.     parameterMap.put("SignatureNonce", UUID.randomUUID().toString());
  12.     parameterMap.put("Format", "XML");
  14.     // 加入方法特有参数
  15.     parameterMap.put("MediaIds", "68a4d2629a339db3207963ac073a88cd");
  17.     // 对参数进行排序
  18.     List<String> sortedKeys = new ArrayList<String>(parameterMap.keySet());
  19.     Collections.sort(sortedKeys);
  21.     // 生成stringToSign字符
  22.     final String SEPARATOR = "&";
  23.     final String EQUAL = "=";
  24.     StringBuilder stringToSign = new StringBuilder();
  25.     stringToSign.append(HTTP_METHOD).append(SEPARATOR);
  26.     stringToSign.append(percentEncode("/")).append(SEPARATOR);
  28.     StringBuilder canonicalizedQueryString = new StringBuilder();
  29.     for (String key : sortedKeys) {
  30.         // 此处需要对key和value进行编码
  31.         String value = parameterMap.get(key);
  32.         canonicalizedQueryString.append(SEPARATOR).append(percentEncode(key)).append(EQUAL).append(percentEncode(value));
  33.     }
  35.     // 此处需要对canonicalizedQueryString进行编码
  36.     stringToSign.append(percentEncode(canonicalizedQueryString.toString().substring(1)));

其中需要注意的是，Timestamp 参数要求符合 ISO8601 规范，并注意使用 UTC 时间，否则会遇到错误。下面的示例代码演示了如何生成符合规范的 Timestamp 字符串：

  1. private static final String ISO8601_DATE_FORMAT = "yyyy-MM-dd'T'HH:mm:ss'Z'";
  2. private static String formatIso8601Date(Date date) {
  3.     SimpleDateFormat df = new SimpleDateFormat(ISO8601_DATE_FORMAT);
  4.     df.setTimeZone(new SimpleTimeZone(0, "GMT"));
  5.     return df.format(date);
  6. }

生成规范化请求字符串（示例中的 canonicalizedQueryString 变量），以及stringToSign 时，都需要进行必要的编码。编码的规则在签名机制一节中有详细描述。下面的示例代码演示了如何用 java.net.URLEncoder 类完成编码：

  1. private static final String ENCODE_TYPE = "UTF-8";
  3. private static String percentEncode(String value) throws UnsupportedEncodingException {
  4.     if (value == null) return null;
  5.     return URLEncoder.encode(value, ENCODE_TYPE).replace("+", "%20").replace("*", "%2A").replace("%7E", "~");
  6. }

假定使用的Access Key Id是”testid”， Access Key Secret是”testKeySecret”，用于计算 HMAC的 Key 就是”testKeySecret&”，最终计算得到的签名值为：

  1.                4wWO2zHYghfp14rz%2BNnZD3zNNoY%3D

下面的示例代码演示了如何计算签名（Java），注意事项（此段代码中有用到org.apache.commons.codec.binary.Base64类，要求包含此类的commons-codec.jar包在1.5及以上，目前发现commons-codec-1.4.jar存在问题）：

  1.     final String ALGORITHM = "HmacSHA1";
  2.     final String ENCODING = "UTF-8";
  3.     final String secret = "testKeySecret";//此处请替换成您的AccessKeySecret
  4.     SecretKey key = new SecretKeySpec((secret + SEPARATOR).getBytes(ENCODE_TYPE), SignatureMethod.HMAC_SHA1);
  5.     Mac mac = Mac.getInstance(ALGORITHM);
  6.     mac.init(key);
  8.     String signature = URLEncoder.encode(new String(
  9.                                                     new Base64().encode(mac.doFinal(stringToSign.toString().getBytes(ENCODE_TYPE))),
  10.                                                     ENCODE_TYPE), ENCODE_TYPE);
  12.     // 生成请求URL
  13.     StringBuilder requestURL;
  14.     requestURL = new StringBuilder("https://mts.aliyuncs.com?");
  15.     requestURL.append(URLEncoder.encode("Signature", ENCODE_TYPE)).append("=").append(signature);
  16.     for (Map.Entry<String, String> e : parameterMap.entrySet()) {
  17.         requestURL.append("&").append(percentEncode(e.getKey())).append("=").append(percentEncode(e.getValue()));
  18.     }

最后得到的requestURL为：

  1.   https://mts.aliyuncs.com?Signature=4wWO2zHYghfp14rz%2BNnZD3zNNoY%3D&Format=XML&AccessKeyId=BlctR6mMqO6mhSxD&Action=QueryMediaList&SignatureMethod=HMAC-SHA1&SignatureNonce=de83cb18-fba7-44d3-b648-4c3ac16ccd2a&SignatureVersion=1.0&Version=2014-06-18&MediaIds=68a4d2629a339db3207963ac073a88cd&Timestamp=2016-04-01T09%3A43%3A18Z

接下来，通过HTTP请求的方式向上面的URL地址发送HTTP请求，并得到视频云点播服务端的响应结果（示例），此处响应结果格式指定为XML：

  1. <?xml version="1.0" encoding="utf-8"?>
  3. <QueryMediaListResponse> 
  4.   <MediaList> 
  5.     <Media> 
  6.       <CreationTime>2016-03-28T13:51:10Z</CreationTime>  
  7.       <MediaInfo> 
  8.         <Format> 
  9.           <FormatName>mov,mp4,m4a,3gp,3g2,mj2</FormatName>  
  10.           <Duration>5.014000</Duration>  
  11.           <FormatLongName>QuickTime / MOV</FormatLongName>  
  12.           <NumStreams>2</NumStreams>  
  13.           <StartTime>0.000000</StartTime>  
  14.           <Bitrate>1124.512</Bitrate>  
  15.           <NumPrograms>0</NumPrograms>  
  16.           <Size>704788</Size> 
  17.         </Format>  
  18.         <Streams> 
  19.           <SubtitleStreamList/>  
  20.           <AudioStreamList> 
  21.             <AudioStream> 
  22.               <Lang>und</Lang>  
  23.               <SampleFmt>fltp</SampleFmt>  
  24.               <CodecName>aac</CodecName>  
  25.               <CodecTimeBase>1/48000</CodecTimeBase>  
  26.               <Timebase>1/48000</Timebase>  
  27.               <CodecTag>0x6134706d</CodecTag>  
  28.               <Channels>2</Channels>  
  29.               <ChannelLayout>stereo</ChannelLayout>  
  30.               <Index>1</Index>  
  31.               <CodecTagString>mp4a</CodecTagString>  
  32.               <Samplerate>48000</Samplerate>  
  33.               <Duration>5.013333</Duration>  
  34.               <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>  
  35.               <StartTime>0.000000</StartTime>  
  36.               <Bitrate>165.448</Bitrate> 
  37.             </AudioStream> 
  38.           </AudioStreamList>  
  39.           <VideoStreamList> 
  40.             <VideoStream> 
  41.               <Lang>und</Lang>  
  42.               <PixFmt>yuv420p</PixFmt>  
  43.               <NetworkCost/>  
  44.               <Dar>0:1</Dar>  
  45.               <Profile>Main</Profile>  
  46.               <Height>720</Height>  
  47.               <Sar>0:1</Sar>  
  48.               <CodecName>h264</CodecName>  
  49.               <Timebase>1/11988</Timebase>  
  50.               <CodecTimeBase>50/2997</CodecTimeBase>  
  51.               <CodecTag>0x31637661</CodecTag>  
  52.               <HasBFrames>0</HasBFrames>  
  53.               <Index>0</Index>  
  54.               <CodecTagString>avc1</CodecTagString>  
  55.               <Duration>5.005005</Duration>  
  56.               <AvgFPS>29.97</AvgFPS>  
  57.               <CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>  
  58.               <Level>40</Level>  
  59.               <StartTime>0.000000</StartTime>  
  60.               <Width>1280</Width>  
  61.               <Fps>29.97</Fps>  
  62.               <Bitrate>951.893</Bitrate> 
  63.             </VideoStream> 
  64.           </VideoStreamList> 
  65.         </Streams> 
  66.       </MediaInfo>  
  67.       <State>Normal</State>  
  68.       <MediaId>68a4d2629a339db3207963ac073a88cd</MediaId>  
  69.       <FileURL>https://inputfirst.oss-test.aliyun-inc.com/mediaWorkflow/noExistQueue/5b7f03fa-f399-4b42-aa27-273bc0fea28d-中文.mp4</FileURL> 
  70.     </Media> 
  71.   </MediaList>  
  72.   <RequestId>373A85E9-AD47-4FAD-B403-9C5E4A371AB2</RequestId> 
  73. </QueryMediaListResponse>

最后更新：2016-11-23 16:04:19

  上一篇：go 类目管理__媒体库管理_开发人员指南_视频点播-阿里云
  下一篇：go 新增媒体工作流__媒体工作流接口_API使用手册_视频点播-阿里云