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

RecordAudio

SIP メディアアプリケーションが、特定の通話 ID からメディアを録音できるよう許可します。例えば、音声メールアプリケーションや、会議参加者のお知らせなどです。アプリケーションは、設定した時間に達するまで、またはユーザーがいずれかの RecordingTerminators を押すか、アプリケーションが無音を検出するまで録音を実行します。このような場合、アクションは、結果のメディアファイルを指定された S3 バケットに配置するようアプリケーションに指示します。S3 バケットは、SIP メディアアプリケーションと同じ AWS アカウントに属している必要があります。さらに、アクションは、Amazon Chime SDK Voice Connector サービスプリンシパル (Amazon Chime SDK Voice Connector サービスプリンシパル) である voiceconnector.chime.amazonaws.com に、s3:PutObject および s3:PutObjectAcl の許可を付与する必要があります。

次の例では、Amazon Chime SDK Voice Connector サービスプリンシパルに s3:PutObject および s3:PutObjectAcl 許可を付与します。

JSON

次の例では、発信者がシャープキー (#) を押したとき、アクティビティなしで 10 秒経過したとき、または発信者が 3 秒間無音状態になったときに録音を停止し、RecordingDestination パラメータで定義された場所に、結果のメディアファイルを書き込みます。

{
    "Type": "RecordAudio",
    "Parameters": {
        "CallId": "call-id-1",
        "DurationInSeconds": "10",
        "SilenceDurationInSeconds": 3,
        "SilenceThreshold": 100,
        "RecordingTerminators": [
            "#"
        ],
        "RecordingDestination": {
            "Type": "S3",
            "BucketName": "valid-bucket-name",
            "Prefix": "valid-prefix-name"
        }
    }
}

ACTION_SUCCESS イベントの処理

録音が終了すると、Amazon Chime SDK SIP メディアアプリケーションは AWS Lambda 関数を呼び出し、呼び出し結果とともに ACTION_SUCCESSFUL イベントを渡します。

{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type" : "RecordAudio",
        "Parameters": {
           ...           
        },
        "RecordingDestination": {
            "Type": "S3",
            "BucketName": "valid-bucket-name",
            "Key": "valid-S3-key"              
        },
        "RecordingTerminatorUsed":"#"
    },
    "CallDetails": {
        ...
    }
}

ACTION_SUCCESSFUL イベントには、ActionData が含まれます (以下のフィールドがあります)。

エラー処理

検証エラーの場合、SIP メディアアプリケーションは適切なエラーメッセージを使用して AWS Lambda 関数を呼び出します。次の表に、発生する可能性のあるエラーメッセージを示します。

ACTION_FAILED イベントの処理

アクションが通話レッグにメディアを記録できない場合、SIP メディアアプリケーションは ACTION_FAILED イベントタイプで AWS Lambda 関数を呼び出します。次の例を参照してください。

{
    "SchemaVersion": "1.0",
    "Sequence": 5,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "RecordAudio",
        "Parameters": {
           ...           
        },
        "ErrorType": "InvalidActionParameter",
        "ErrorMessage": "RecordingDestination parameter value is invalid."
    },
    "CallDetails": {
        ...
    }
}

GitHub の実際の例 (https://github.com/aws-samples/amazon-chime-sma-bridging) を参照してください。