閱讀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使用手冊_視頻點播-阿裏雲