View a markdown version of this page

トラブルシューティング - Amazon Kinesis Video Streams
Amazon S3 バケットに配信されないイメージ

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

トラブルシューティング

Amazon S3 バケットに配信されないイメージ

この問題のトラブルシューティングには、注意すべき点がいくつかあります。

  1. アクセス許可がない

  2. イメージ生成設定が正しくない

  3. タグがフラグメントに追加されませんでした

アクセス許可がない

カスタマーマネージド KMS キーを使用している場合は、次のように、PutMedia呼び出しを実行するロール (アップローダー) に適切な暗号化および復号アクセス許可があり、Amazon S3 バケットにアクセスできることを確認します。

  • kms:Encrypt

  • kms:GenerateDataKey

  • kms:Decrypt

  • s3:PutObject

詳細については、「サーバー側の暗号化の使用開始方法」を参照してください。

送信先を確認する

AWS CLI を使用して、ストリームの DescribeImageGenerationConfiguration API を呼び出します。

aws kinesisvideo describe-image-generation-configuration \
  --stream-name "demo-stream"

レスポンスDestinationConfigの を確認し、正しく見えることを確認します。

イメージ生成タグがフラグメントに追加されていることを確認します。

  1. putKinesisVideoEventMetadata 呼び出しが成功したことを確認します。

    putKinesisVideoEventMetadata メソッドは、成功するとステータスコード 0 を返します。0 の関数の戻り値を確認することをお勧めします。0 以外のステータスコードが返された場合は、それを 16 進数に変換し、 エラーコードのリファレンスで詳細を確認してください。

    エラーログがオンになっていることを確認し、アプリケーション内の他のエラーがないかログを確認します。アプリケーションのフレーム送信呼び出しパターンを確認して、推奨される実装と比較します。 フラグメントへのイメージ生成タグの追加

  2. ローカルで生成された MKV ファイルを検証する

    プロデューサー SDK またはサンプルアプリケーションがタグを正しく追加したことを確認します。

    1. KVS_DEBUG_DUMP_DATA_FILE_DIR 環境変数を設定します。この値が設定されている場合、プロデューサー SDK は Kinesis Video Streams に送信したメディアファイルを指定された場所に書き込みます。

      export KVS_DEBUG_DUMP_DATA_FILE_DIR=/path/to/output/directory
      注記

      パスが存在しない場合、SDK は新しいディレクトリを作成しません。必要に応じて フォルダを作成します。

    2. アプリケーションを再度実行します。指定した出力ディレクトリに書き込まれる.mkvファイルが表示されます。

    3. MKVToolNix または他のソフトウェアを使用して、タグが存在することを確認します。

      1. MKVToolNix をインストールします。 brew install mkvtoolnix

      2. 出力ディレクトリのいずれかの.mkvファイルを使用して MKVToolNix を実行します。

        mkvinfo -v ./path/to/video/file

      3. MKVToolNix 出力を確認します。プロKinesisVideoStream::PutFragmentMetadataデューサー SDK メソッドが正しく呼び出された場合、次の MKV タグが表示されます。

        |+ Tags
| + Tag
|  + Simple
|   + Name: AWS_KINESISVIDEO_IMAGE_GENERATION
        注記

        タグは、その前のクラスターに属します。

    4. MKV タグが存在しない場合は、プロKinesisVideoStream::PutEventMetadataデューサー SDK メソッドが STREAM_EVENT_TYPE_IMAGE_GENERATION引数で呼び出され、成功 (0) コードを返したことを確認します。