すべてのプロダクト
Search
ドキュメントセンター

:サンプルコード

最終更新日:Feb 28, 2025

ApsaraVideo Media Processing(MPS)の API 操作を呼び出すには、HTTP または HTTPS 経由で MPS サーバーにリクエストを送信します。その後、MPS サーバーはレスポンスを返します。 MPS サーバーはリクエストを受信すると、リクエストの認証とパラメーター検証を実行します。認証とパラメーター検証に合格すると、MPS サーバーはリクエストで指定されたパラメーターに基づいて必要な操作を送信または完了し、HTTP レスポンスで呼び出し元に処理結果を返します。

手順

  1. リクエストパラメーターを準備します。

  2. リクエストパラメーターを使用して正規化されたクエリ文字列を作成します。

  3. 署名対象文字列を作成します。

  4. 署名対象文字列の HMAC 値を計算し、HMAC 値を Base64 でエンコードします。

  5. リクエスト URL を作成します。

次のサンプルコードは、Java でリクエストを構築する方法の例を示しています。

グローバルパラメーターの設定


private static final String ENCODE_TYPE = "UTF-8";
private static final String ALGORITHM = "HmacSHA1";
private static final String HTTP_METHOD = "GET";
private static final String SEPARATOR = "&";
private static final String EQUAL = "=";

リクエストパラメーターの準備


Map parameterMap = new HashMap();
// 共通リクエストパラメーター。
parameterMap.put("Action", "SearchTemplate");
parameterMap.put("Version", "2014-06-18");
parameterMap.put("AccessKeyId", "testId"); // testId をご自身の AccessKey ID に置き換えます。
parameterMap.put("Timestamp", "2015-05-14T09:03:45Z");// このタイムスタンプはテスト用に固定されています。このように、サンプルコードで生成される署名値は変更されないため、データの比較と検証が容易になります。可変タイムスタンプを生成するには、このコード行を次の行に置き換えます。
//parameterMap.put("Timestamp", formatIso8601Date(new Date())); 
parameterMap.put("SignatureMethod", "HMAC-SHA1");
parameterMap.put("SignatureVersion", "1.0");
parameterMap.put("SignatureNonce", "4902260a-516a-4b6a-a455-45b653cf6150"); // 一意の乱数はテスト用に固定されています。このように、サンプルコードで生成される署名値は変更されないため、データの比較と検証が容易になります。可変の一意の乱数を生成するには、このコード行を次の行に置き換えます。
//parameterMap.put("SignatureNonce", UUID.randomUUID().toString());
parameterMap.put("Format", "XML"); // JSON 形式もサポートされています。

リクエストパラメーターを使用して正規化されたクエリ文字列を構築する


private static String percentEncode(String value) throws UnsupportedEncodingException {
return URLEncoder.encode(value, ENCODE_TYPE).replace("+", "%20").replace("*", "%2A").replace("%7E", "~");
}
private static String buildCanonicalizedQueryString(Map parameterMap) throws UnsupportedEncodingException {
// パラメーターをソートします。
List sortedKeys = new ArrayList(parameterMap.keySet());
Collections.sort(sortedKeys);
StringBuilder temp = new StringBuilder();
for (String key : sortedKeys) {
// パラメーターと値をエンコードします。
String value = parameterMap.get(key);
temp.append(SEPARATOR).append(percentEncode(key)).append(EQUAL).append(percentEncode(value));
}
return temp.toString().substring(1);
}

署名対象文字列の HMAC 値を計算し、HMAC 値を Base64 でエンコードする


private static String buildStringToSign(String canonicalizedQueryString) throws UnsupportedEncodingException {
// 署名対象文字列を生成します。
StringBuilder temp = new StringBuilder();
temp.append(HTTP_METHOD).append(SEPARATOR);
temp.append(percentEncode("/")).append(SEPARATOR);
// 正規化されたクエリ文字列をエンコードします。
temp.append(percentEncode(canonicalizedQueryString));
return temp.toString();
}
private static String buildSignature(String keySecret, String stringToSign) throws UnsupportedEncodingException, InvalidKeyException, NoSuchAlgorithmException {
SecretKey key = new SecretKeySpec((keySecret + SEPARATOR).getBytes(ENCODE_TYPE), SignatureMethod.HMAC_SHA1);
Mac mac = Mac.getInstance(ALGORITHM);
mac.init(key);
byte[] hashBytes = mac.doFinal(stringToSign.toString().getBytes(ENCODE_TYPE));
byte[] base64Bytes = new Base64().encode(hashBytes);
String base64UTF8String = new String(base64Bytes, "utf-8");
return URLEncoder.encode(base64UTF8String, ENCODE_TYPE);
}

リクエスト URL の作成


private static String buildRequestURL(String signature, Map parameterMap) throws UnsupportedEncodingException {
// リクエスト URL を生成します。
StringBuilder temp = new StringBuilder("http://mts.aliyuncs.com/?");
temp.append(URLEncoder.encode("Signature", ENCODE_TYPE)).append("=").append(signature);
for (Map.Entry e : parameterMap.entrySet()) {
temp.append("&").append(percentEncode(e.getKey())).append("=").append(percentEncode(e.getValue()));
}
return temp.toString();
}

  • リクエストパラメーターを準備します。

    • testId を AccessKeyId パラメーターに設定します。

    • testKeySecret を AccessKey シークレットに設定します。

    • 2015-05-14T09:03:45Z を Timestamp パラメーターに設定します。

    • 4902260a-516a-4b6a-a455-45b653cf6150 を SignatureNonce パラメーターに設定します。

    • SearchTemplate を Action パラメーターに、2 を PageSize パラメーターに設定します。

    • XML を Format パラメーターに設定します。

  • リクエストパラメーターを使用して、正規化されたクエリ文字列を構築します。

    AccessKeyId=testId&Action=SearchTemplate&Format=XML&PageSize=2&SignatureMethod=HMAC-SHA1&SignatureNonce=4902260a-516a-4b6a-a455-45b653cf6150&SignatureVersion=1.0&Timestamp=2015-05-14T09%3A03%3A45Z&Version=2014-06-18
  • 署名対象文字列を作成します。

    GET&%2F&AccessKeyId%3DtestId&Action%3DSearchTemplate&Format%3DXML&PageSize%3D2&SignatureMethod%3DHMAC-SHA1&SignatureNonce%3D4902260a-516a-4b6a-a455-45b653cf6150&SignatureVersion%3D1.0&Timestamp%3D2015-05-14T09%253A03%253A45Z&Version%3D2014-06-18
  • 署名対象文字列の HMAC 値を計算し、HMAC 値を Base64 でエンコードします。

    kmDv4mWo806GWPjQMy2z4VhBBDQ%3D
  • リクエスト URL を作成します。

    http://mts.cn-hangzhou.aliyuncs.com/?Signature=kmDv4mWo806GWPjQMy2z4VhBBDQ%3D&SignatureVersion=1.0&Action=SearchTemplate&Format=XML&SignatureNonce=4902260a-516a-4b6a-a455-45b653cf6150&PageSize=2&Version=2014-06-18&AccessKeyId=testId&SignatureMethod=HMAC-SHA1&Timestamp=2015-05-14T09%3A03%3A45Z
  • URL に HTTP リクエストを送信し、サーバーからレスポンスを取得します。たとえば、cURL を使用してリクエストを送信できます。この例のレスポンスは XML 形式で返されます。

    <SearchTemplateResponse>
            <RequestId>017F1B2D-2B5B-4441-ABBA-E0DC08F5AFEC</RequestId>
            <Template>
                <Id>88c6ca184c0e47098a5b665e2a126799</Id>
                <Name>MTS-example</Name>
                <Container>
                    <Format>mp4</Format>
                </Container>
                <Video>
                    <Codec>H.264</Codec>
                    <Profile>high</Profile>
                    <Bitrate>Auto</Bitrate>
                    <Crf>15</Crf>
                    <Width>256</Width>
                    <Height>800</Height>
                    <Fps>25</Fps>
                    <Gop>10</Gop>
                    <Preset>lower</Preset>
                    <ScanMode></ScanMode>
                    <Bufsize>6000</Bufsize>
                    <Maxrate></Maxrate>
                    <BitrateBnd>
                       <Max></Max>
                       <Min></Min>
                    </BitrateBnd>
                </Video>
                <Audio>
                    <Codec>aac</Codec>
                    <Samplerate>44100</Samplerate>
                    <Bitrate>500</Bitrate>
                    <Channels>2</Channels>
                </Audio>
                <State>Normal</State>
            </Template>
        </SearchTemplateResponse>