本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 针对 Amazon Chime SDK 使用呼叫分析配置
要使用呼叫分析配置处理音频，必须创建呼叫分析管道，也称为媒体见解管道。管道是在呼叫期间创建的，用于处理音频，并在呼叫结束时终止。呼叫分析管道需要呼叫分析配置的 ARN 以及有关音频源的信息。呼叫分析配置包括有关音频处理器、见解目的地和警报事件配置的详细信息，*但不包括音频源*。这允许您在不同的呼叫分析工作流程中重复使用配置，例如使用不同的 Voice Connector 或 KVS 源。呼叫分析管道调用配置中指定的机器学习服务并录制音频。呼叫结束后，您可以手动或自动停止管道。
您可以在各种用例中使用呼叫分析管道。以下工作流程介绍了使用呼叫分析配置和管道的潜在方法。
**Topics**
+ [了解 Amazon Chime SDK 的通话录音工作流程](recording-workflows.md)
+ [了解 Amazon Chime SDK 基于机器学习的分析工作流程](ml-based-analytics.md)
# 了解 Amazon Chime SDK 的通话录音工作流程
本节中的主题列出并描述了录制通话和 Kinesis 视频流的工作流程。
# 录制 Voice Connector 通话
在以下情况下使用此工作流程：
+ 您已经使用或计划使用 Voice Connector 将 SIP 媒体引入呼叫分析。
**注意**
Voice Connector 支持 SIP 和 SIPREC。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[管理 Amazon Chime SDK Voice Connector](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html)。
+ 您想以低延迟自动录制到您选择的 Amazon Simple Storage Service 目的地的 SIP 或 SIPREC 呼叫。
+ 您想使用 Amazon Chime SDK 控制台来创建配置并将其与 Voice Connector 关联。
+ 您想对每个 Voice Connector 呼叫应用相同的录音配置。如果要对一个或多个 Voice Connector 应用多种配置，请参阅下一节。
要启用以编程方式调用，请使用以下 Amazon Ch APIs ime 软件开发工具包。
+ 使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 创建呼叫分析配置
+ 使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceConnector.html) 创建 Voice Connector。
+ 使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) API 将配置与 Voice Connector 关联。
有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[配置 Voice Connector 以使用呼叫分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
下图显示了 Voice Connector 启动呼叫录音会话时的数据流。图表中的数字对应于下面的带编号的文本。
![\[该图显示了 Voice Connector 开始录制呼叫时的数据流。\]](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)
在图中：
1. 使用 Amazon Chime SDK 控制台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 创建呼叫分析配置。在配置创建过程中，您只需激活通话录音，选择所需的录音文件格式，然后指定用于存储录音文件的 Amazon S3 目标即可。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[创建呼叫分析配置](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-ca-config.html)。
1. 您可以使用 Amazon Chime SDK 控制台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) API 将配置与 Voice Connector 关联起来。要使用控制台，请参阅[配置 Voice Connector 以使用呼叫分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
1. 在拨出呼叫期间，Voice Connector 会接收每个呼叫参与者的音频。
1. 如果将呼叫分析录音配置附加到 Voice Connector，则 Voice Connector 服务将使用媒体管道服务启动呼叫分析录音会话。
1. 媒体管道服务启动监视正在进行的呼叫的呼叫录音处理器。
1. 通话结束后，媒体管道服务会将通话录音文件传送到指定的 Amazon S3 存储桶，并通过 Amazon Kinesis Data Streams 提供录音元数据。如果启用了数据仓库，则呼叫元数据也会进入 Amazon Simple Storage Service 数据仓库。如果使用 SIPREC 将 SIP 音频整合到呼叫分析中，则呼叫元数据会纳入表格格式的 SIPREC 元数据。有关录音表的更多信息，请参阅本节后文中的 [了解 Amazon Chime 软件开发工具包 AWS Glue 的数据目录表](glue-tables.md)。
1. 媒体管道服务将管道状态事件发送到默认的 Amazon EventBridge。有关更多信息，请参阅本指南中的[使用 EventBridge 通知](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html)。
**注意**
请注意，您必须启用 Voice Connector 流媒体才能使用 Voice Connector 进行录音。此功能允许将通话数据流式传输到您账户中由 Voice Connector 管理的 Kinesis 视频流。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[将 Amazon Chime SDK Voice Connector 媒体流式传输到 Kinesis 视频流](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html)。
您还可以将 Voice Connector 创建的呼叫数据存储在 Kinesis 视频流中，持续时间各不相同，从几小时到几天甚至几年。选择不保留数据会限制呼叫数据的可用性，便于立即使用。Kinesis 视频流的成本是根据使用的带宽和总存储空间来确定的。您可以随时在 Voice Connector 流媒体配置中调整数据保留期。要启用呼叫分析录音，您必须确保 Kinesis 视频流将数据保留足够长的时间以进行呼叫分析。您可以通过指定合适的数据保留期来达到此目的。
您可以根据需要将呼叫见解管道配置与任意数量的 Voice Connector 相关联。您也可以为每个 Voice Connector 创建不同的配置。语音连接器使用代表您 AWSServiceRoleForAmazonChimeVoiceConnector 为每个交易 ID 调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API 一次。有关该角色的信息，请参阅《Amazon Chime SDK 管理员指南》**中的[为 Amazon Chime SDK Voice Connector 使用 Amazon Chime SDK 服务相关角色](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream)。
# 与 Amazon Kinesis 视频流制作人一起录制
在以下情况下，您可以录制 Amazon Kinesis 视频流：
+ 您需要对呼叫应用不同的配置，而不是为每个 Voice Connector 呼叫使用相同的配置。
+ 您想要录制未由 Voice Connector 处理的 SIP 或非 SIP 音频。
要使用此通话录音选项，您需要将音频发布到 Kinesis 视频流（KVS），然后使用 KVS 流频道信息和呼叫分析配置 ARN 调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
**注意**
通话分析最多 APIs 支持两个音频通道。您也可以启用 Voice Connector 流式传输，然后使用语音连接器 EventBridge 通知中发布的 KVS 信息启动通话录音。
在调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API 时，您可以选择是否为每个 KVS 流频道定义指定片段编号。如果您提供片段编号，则呼叫分析将开始处理该片段上的流。如果您未指定片段 ID，则呼叫分析将开始处理来自最新可用片段的流。
下图显示了 Voice Connector 启动呼叫录音会话时的数据流。图表中的数字对应于下面的带编号的文本。
![\[该图显示了 Voice Connector 开始录制呼叫时的数据流。\]](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/call-analytics-workflow-2.png)
在图中：
1. 您可以使用 Amazon Chime SDK 控制台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 来创建通话录音配置。
1. 使用 AWS SDK 创建可将外部音频推送到 KVS 的应用程序，或者启用 Voice Connector 流式传输将通话音频自动发布到 KVS。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[将 Amazon Chime SDK Voice Connector 媒体流式传输到 Kinesis 视频流](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html)。
1. 如果启用了语音连接器流式传输，则语音连接器服务会将通知发送到默认设置 EventBridge。
1. 如果是 Voice Connector 流式传输，您的应用程序可以使用来自的 Amazon Chime Voice Connector 流媒体`STARTED`事件 EventBridge 来收集有关通话时段的 KVS 直播信息。
1. 当您的应用程序获得来自 Voice Connector 流式传输事件或外部来源的音频信息后，您的应用程序就会调用 Amazon Chime SDK [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
1. 媒体管道服务启动监视正在进行的呼叫的呼叫录音处理器。
1. 媒体管道服务将管道状态事件发送到默认的 Amazon EventBridge。有关更多信息，请参阅[使用 EventBridge 通知](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html)。
1. 通话完成后，媒体管道服务会将通话录音文件传送到指定的 Amazon S3 存储桶，并通过 Amazon Kinesis Data Streams 提供录音元数据。如果启用了数据仓库，则呼叫元数据也将发送到 Amazon S3 数据仓库。如果使用 SIPREC 将 SIP 音频整合到呼叫分析中，则呼叫元数据会纳入采用方便表格格式的 SIPREC 元数据。有关录音表的更多信息，请参阅本节后文中的 [了解 Amazon Chime 软件开发工具包 AWS Glue 的数据目录表](glue-tables.md)。
1. 您的应用程序可以使用发布到 Amazon 的事件监控管道，如果是语音连接器，还可以监控通话状态 EventBridge。有关更多信息，请参阅本指南中的[使用 EventBridge 通知](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html)。
1. 要终止录音，请调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_DeleteMediaPipeline.html) API 终止通话录音。
有关基于 API 的录制和示例，请参阅本指南中的 [Amazon S3 录制接收器](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-processors-sinks.html#ca-s3-recording-sink)。
# 使用 CLI 开始录制
本节中的示例向您说明如何执行以下操作：
+ 使用 CLI 运行呼叫分析配置并调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)。
+ 使用 CLI 指定录制目标、音频文件格式和音频文件名。
**Topics**
+ [运行配置并启动管道](#cli-run-config)
+ [设置目的地、名称和格式](#cli-set-buckets-formats)
## 运行配置并启动管道
使用以下命令运行配置并启动媒体见解管道。pipeline.json 文件包含配置设置。
```
aws chime-sdk-media-pipeline create-media-insights-pipeline --cli-input-json file://pipeline.json
```
以下示例介绍了典型的 `pipeline.json` 文件。
```
{
"MediaInsightsPipelineConfigurationArn": arn:aws:chime:region;account_id:media-insights-pipeline-configuration/MyConfiguration,
"KinesisVideoStreamRecordingSourceRuntimeConfiguration": {
"Streams": [
{
"StreamArn": kinesis_video_stream_arn_1
},
{
"StreamArn": kinesis_video_stream_arn_2
}
],
"FragmentSelector": {
"FragmentSelectorType": "selector_type", // Specify "server_timestamp" or "producer_timestamp" as the fragment selector type
"TimestampRange": {
"StartTimestamp": epoch_time_seconds,
"EndTimestamp": epoch_time_seconds
}
}
},
"S3RecordingSinkRuntimeConfiguration": {
"Destination": arn:aws:s3:::bucket_name/prefix/optional_file_name,
"RecordingFileFormat": file_format // Specify "Opus" or "WAV" as the recording file format, if you want to override the configuration
}
}
```
`MediaInsightsPipelineConfigurationArn` 是您在创建呼叫分析配置后收到的配置 ARN。
## 设置目的地、名称和格式
以下示例使用名为 `MyRecordingBucket` 的文件夹用作 `S3SinkConfiguration.Destination` 值，将 `Opus` 用作 `RecordingFileFormat` 值。
```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.ogg
```
以下示例将 `MyRecordingBucket` 用作 `S3SinkConfiguration.Destination` 值，将 `Wav` 用作 `RecordingFileFormat` 值。
```
arn:aws:s3:::MyRecordingBucket/voice-connector-id/transaction-id_year-month-date-hour-minute-second-millisecond.wav
```
# 了解 Amazon Chime SDK 基于机器学习的分析工作流程
下面几节介绍如何从 Amazon Chime SDK 呼叫分析工具包提供的机器学习分析功能。
**注意**
如果您计划在同一 Kinesis 视频流上运行多个机器学习分析，则可能需要提高视频流 `GetMedia` 和 `GetMediaForFragmentList` 的连接级别限制。有关更多信息，请参阅《Kinesis 视频流开发者指南》**中的 [Kinesis 视频流限制](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html)。
# 使用 Voice Connector 自动启动呼叫分析
在以下情况下使用此工作流程：
+ 您需要控制台驱动的设置。
+ 您已经使用或计划使用 Voice Connector 将 SIP 媒体引入呼叫分析。Voice Connector 支持 SIP 和 SIPREC。有关配置 Voice Connector 的更多信息，请参阅[管理 Amazon Chime SDK Voice Connector](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html)。
+ 您希望将相同的媒体见解配置应用于每个 Voice Connector 呼叫。
+ 您需要使用 Amazon Chime SDK 语音分析，这需要 Voice Connector 或媒体见解管道。
要在 Amazon Chime SDK 控制台中启用此工作流程，请按照[配置 Voice Connector 以使用呼叫分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)中的步骤创建录音配置。
要以编程方式启用此工作流程，请使用以下 APIs：[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API 创建呼叫分析配置，然后使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html)API 将配置关联到语音连接器。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[配置 Voice Connector 以使用语音分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
下图显示了 Voice Connector 启动呼叫分析会话时的数据流。图表中的数字对应于下面的带编号的文本。
![\[Image showing the flow of data when a Voice Connector initiates a call.\]](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/call-analytics-workflow-1.png)
在图中：
1. 您可以使用 Amazon Chime SDK 控制台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 来创建媒体见解管道配置。
1. 您可以使用 Amazon Chime SDK 控制台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_PutVoiceConnectorStreamingConfiguration.html) API 将配置与 Voice Connector 关联起来。要将现有配置与 Voice Connector 相关联，请参阅《Amazon Chime SDK 管理员指南》**中的[配置 Voice Connector 以使用呼叫分析](https://docs.aws.amazon.com/chime-sdk/latest/ag/configure-voicecon.html)。
1. 在拨出呼叫期间，Voice Connector 会接收每个呼叫参与者的音频。
1. 由于与呼叫分析的内置集成，如果将呼叫分析配置附加到 Voice Connector，则 Voice Connector 服务将使用媒体管道服务启动呼叫分析会话。
1. 媒体管道服务调用配置中指定的一个或多个媒体处理器。
1. 媒体管道服务根据配置将输出数据发送到一个或多个目的地。例如，您可以通过 Amazon Kinesis Data Streams 发送实时分析，如果已配置，则可以将呼叫元数据和分析数据发送到 Amazon S3 数据仓库。
1. 媒体管道服务将管道状态事件发送到默认的 Amazon EventBridge。如果您已配置规则，则这些规则的通知也将发送到 EventBridge Amazon。有关更多信息，请参阅[使用 EventBridge 通知](https://docs.aws.amazon.com/chime-sdk/latest/dg/ca-eventbridge-notifications.html)。
**注意**
语音分析处理器只有在您调用[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)或时才会自动启动[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartVoiceToneAnalysisTask.html) APIs。
您必须启用 Voice Connector 流媒体才能将呼叫分析与 Voice Connector 结合使用。此功能允许将通话数据流式传输到您账户中由 Voice Connector 管理的 Kinesis 视频流。有关更多信息，请参阅《Amazon Chime SDK 管理员指南》**中的[将 Amazon Chime SDK Voice Connector 媒体流式传输到 Kinesis 视频流](https://docs.aws.amazon.com/chime-sdk/latest/ag/start-kinesis-vc.html)。
您可以将 Voice Connector 通话数据存储在 Kinesis 视频流中，存储时间各不相同，从数小时到数年不等。选择不保留数据会限制呼叫数据的可用性，便于立即使用。Kinesis 视频流的成本是根据使用的带宽和总存储空间来确定的。通过编辑 Voice Connector 的流媒体配置，可以随时调整数据保留期。要启用呼叫分析录音，您必须确保 Kinesis 视频流在呼叫分析完成之前保留数据。您可以通过指定合适的数据保留期来达到此目的。
您可以根据需要将媒体见解管道配置与任意数量的 Voice Connector 相关联。您也可以为每个 Voice Connector 创建不同的配置。语音连接器使用代表您 AWSServiceRoleForAmazonChimeVoiceConnector 为每个交易 ID 调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html)API 一次。有关该角色的信息，请参阅《Amazon Chime SDK 管理员指南》**中的[为 Amazon Chime SDK Voice Connector 使用 Amazon Chime SDK 服务相关角色](https://docs.aws.amazon.com/chime-sdk/latest/ag/using-service-linked-roles-stream.html#service-linked-role-permissions-stream)。
# 将呼叫分析 APIs 与语音连接器结合使用
如果您使用 Voice Connector，但需要控制何时应用呼叫分析配置以及将配置应用于哪个呼叫，请使用此工作流程。
要使用此方法，您需要为 Voice Connector 发布的事件创建 EventBridge 目标，然后使用这些事件触发呼叫分析管道 APIs。有关更多信息，请参阅[《亚马逊 Chime 软件开发工具包管理员指南》中的 “ EventBridge使用自动化 Amaz *on Chime* 软件开发工具包](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html)”。
下图显示了在 Voice Connector 中使用呼叫分析时如何实现更精细的控制。图表中的数字对应于下方文本中的数字。
![\[该图显示了通过 Voice Connector 使用 API 调用时的数据流。\]](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/analytics-vc-with-apis.png)
在下图中：
1. 您可以使用 Amazon Chime SDK 控制台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html) API 来创建媒体见解管道配置。
1. 在拨出呼叫期间，Voice Connector 将接收参与者的音频。
1. 语音连接器将通话音频发送到 Kinesis 视频流，并将相应的事件发送到。 EventBridge这些事件具有流和通话元数据。
1. 您的应用程序是 EventBridge 通过 Targe EventBridge t 订阅的。
1. 您的应用程序调用了 Amazon Chime SDK [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
1. 媒体管道服务根据媒体见解管道配置中的处理器元素调用一个或多个媒体处理器。
1. 媒体管道服务根据配置将输出数据发送到一个或多个目的地。Amazon Chime SDK 呼叫分析将通过 Amazon Kinesis Data Streams 提供实时分析，如果已配置，则可对 Amazon S3 数据仓库进行调用元数据分析。
1. 媒体管道服务将事件发送到 Amazon EventBridge。如果您已配置规则，则这些规则的通知也将发送到 EventBridge Amazon。
1. 您可以通过调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html) API 来暂停或恢复呼叫分析会话。
**注意**
通话录音不支持暂停和恢复通话。此外，当您暂停会话时，为呼叫启动的语音分析任务也会停止。要重新启动它们，必须调用[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)或[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs。
1. 如果您在配置期间选择语音分析，则可以通过调用[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)或开始语音分析[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs。
# 与 Kinesis 视频流制作人一起使用呼叫分析
要使用此选项，您需要将音频数据发布到 Kinesis 视频流（KVS），然后使用 KVS 流频道信息调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
**注意**
通话分析最多 APIs 支持两个音频通道。
在调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API 时，您可以为每个 KVS 流频道定义指定片段编号。如果您提供片段编号，则呼叫分析将开始处理该片段上的流。否则，呼叫分析将开始处理来自最新可用片段的流。
呼叫分析支持 PCM 音频（仅限带签名的 16 位小端序音频格式，不包括 WAV），音频采样率介于 8kHz 和 48kHz 之间。低质量的音频（例如电话音频）通常在 8,000Hz 左右。高质量音频的范围通常在 16,000Hz 到 48,000Hz 之间。您指定的采样率必须与音频的采样率相匹配。如需了解更多信息，请参阅《Amazon Chime SDK API 参考》**中的 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_KinesisVideoStreamSourceRuntimeConfiguration.html)。
Kinesis Video Streams 创建者开发工具包提供了一组库，您可以用这些库将音频数据流式传输到 Kinesis 视频流。有关更多信息，请参阅《Amazon Kinesis Video Streams 开发者指南》**中的 [Kinesis 视频流创建者库](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk.html)。
下图显示了与自定义 Kinesis Video Streams 创建者一起使用呼叫分析时的数据流。图表中的数字对应于下面的带编号的文本。
![\[该图显示了与 Kinesis Video Streams 创建者一起使用呼叫分析时的数据流。\]](http://docs.aws.amazon.com/zh_cn/chime-sdk/latest/dg/images/analytics-kvs-with-apis.png)
1. 您可以使用 AWS 控制台或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipelineConfiguration.html)API 创建媒体见解管道配置。
1. 您可以使用 Kinesis Video Streams 创建者向 Kinesis 视频流写入音频。
1. 您的应用程序中会调用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。
1. 媒体管道服务从客户的 Kinesis 视频流读取音频。
1. 媒体管道服务将事件发送到 Amazon EventBridge。如果您已配置规则，则这些规则的通知也将发送到 EventBridge Amazon。
1. 媒体管道服务调用一个或多个处理器元素。
1. 媒体管道服务将输出数据发送到一个或多个接收器元素。
1. 您可以通过调用 [ UpdateMediaInsightsPipelineStatus](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_UpdateMediaInsightsPipelineStatus.html) API 来暂停或恢复呼叫分析会话。
**注意**
通话录音不支持暂停和恢复。
1. 您的应用程序可以处理 Amazon EventBridge 事件以触发自定义业务工作流程。
1. 如果您在创建配置时选择语音分析，则应用程序可以通过调用[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html)或来启动语音分析[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartVoiceToneAnalysisTask.html) APIs。