取り込みドメインのストリーム取り込みコールバックを設定します。

使用状況ノート

このインターフェイスは、取り込みドメイン名のコールバックアドレスと認証情報の設定をサポートします。

QPS limit

1人のユーザーが1秒あたり最大15クエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 String 必須 SetLiveStreamsNotifyUrlConfig

実行する操作です。 Set the value to SetLiveStreamsNotifyUrlConfig.

DomainName String 必須 demo.aliyundoc.com

取り込みドメイン。

NotifyUrl String 必須 http://guide.aliyundoc.com/notify

ストリーム取り込みに関するコールバック通知の送信先のURL。

NotifyReqAuth String 任意 はい

認証を有効にするかどうかを指定します。 設定可能な値は以下のとおりです。

  • はい
  • いいえ

デフォルト値: no

NotifyAuthKey String 任意 123 ***

暗号化キー。 このパラメーターは、NotifyReqAuthパラメーターがyesに設定されている場合に必要です。

レスポンスパラメーター

パラメーター データ型 説明
RequestId String 40A4F36D-A7CC-473A-88E7-154F92242566

リクエストの ID です。

リクエストの例

http(s):// live.aliyuncs.com/?Action=SetLiveStreamsNotifyUrlConfig
&DomainNam e=demo.aliyundoc.com
&NotifyUrl=http://guide.aliyundoc.com/notify
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<SetLiveStreamsNotifyUrlConfigResponse>
      <RequestId>4C747C97-7ECD-4C61-8A92-67AD806331FF</RequestId>
</SetLiveStreamsNotifyUrlConfigResponse>

JSON 形式

{
    "RequestId":"4C747C97-7ECD-4C61-8A92-67AD806331FF"
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。

コールバックロジック

ライブストリーム取り込みステータスのコールバックロジック:

Real-Time Messaging Protocol (RTMP) によるストリーム取り込み中、ApsaraVideo Liveは、ApsaraVideo LiveがOnPublishメッセージを受信してから2秒以内にストリーム取り込みクライアントが接続を閉じるかどうかを確認します。 ストリーム取り込みクライアントが接続を閉じない場合、ApsaraVideo Liveはストリーム取り込みの成功に関するコールバック通知を送信します。 接続確立後にApsaraVideo Liveがライブストリーミングデータを受信した場合にのみ、このコールバック通知の送信をApsaraVideo Liveに要求することができます。 In this case, submit a ticket.

For example, you have Ingest Domain A and Streaming Domain B, and you use the stream pulling feature for live streaming under Streaming Domain B. You can configure ApsaraVideo Live to pull a stream at the specified point in time, or allow ApsaraVideo Live to automatically pull a stream when the origin server starts live streaming. ストリームプルステータスに関するコールバック通知を受信する場合は、取り込みドメインaのストリームインジェストコールバックを設定します。設定後、ApsaraVideo Liveはストリームインジェストステータスと同じコールバックロジックを使用して、ストリーミングドメインBでストリームプルステータスに関するコールバック通知を送信します。デフォルトでは、apsaraVideo Liveは、接続が確立されてから2秒以内にストリームプルクライアントが接続を閉じない場合、ストリームプルの成功に関するコールバック通知を送信します。

We recommend that you deliver the streaming URL only after you determine that stream ingest or pulling is successful based on callback notifications and the list of online streams.

Callback authentication logic

The callback authentication is disabled by default. コールバックURLの設定中に有効にできます。 The authentication logic is as follows:
  1. ApsaraVideo Liveには、コールバック情報をコールバックURLに送信する際に、HTTP(S) リクエストヘッダーにALI-LIVE-TIMESTAMPフィールドとALI-LIVE-SIGNATUREフィールドが含まれます。 ALI-LIVE-SIGNATUREの値は、次の式を使用して計算されます。

    ALI-LIVE-SIGNATURE=MD5SUM (MD5CONTENT)

    MD5CONTENT= ストリームプッシュドメイン名 | ALI-LIVEの値-TIMESTAMP | 暗号鍵
    Stream pushingドメイン名は、コールバックURLが設定されているドメインを参照します。 暗号鍵は、コールバックURLの認証鍵を参照します。
  2. コールバックURLをホストするサーバーは、ストリームプッシュドメイン名、ALI-LIVE-TIMESTAMPの値、および暗号キーの連結文字列からMD5ハッシュを生成します。 It then compares the MD5 hash with the value of ALI-LIVE-SIGNATURE in the HTTP(S) request header. If the MD5 hash is not consistent with the value of ALI-LIVE-SIGNATURE, the request is considered invalid.

特殊エラーコード

エラーコード

エラーメッセージ

HTTP ステータスコード

説明

InternalError

不明なエラーにより、リクエスト処理が失敗しました。

500

不明なエラーが発生した場合に返されるエラーメッセージ。

InvalidDomain.NotFound

The domain provided does not exist in our records.

404

ドメイン名がAlibaba Cloudアカウントに属していない場合に返されるエラーメッセージ。

IllegalOperation

Illegal domain operate is not permitted.

403

The error message returned because the current operation is not supported. たとえば、指定されたドメイン名はライブドメインではありません。

InvalidNotifyUrl.Malformed

Specified parameter NotifyUrl is not valid.

400

The error message returned because the callback URL is not a valid HTTP URL.

InvalidNotifyUrl.Unsafe

指定されたNotifyUrlは安全ではありません。

400

The error message returned because the URL used to receive notifications is unsafe.