本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS HealthScribe 串流
<a name="health-scribe-streaming"></a>

透過 AWS HealthScribe 串流，您可以即時轉錄醫療對話。 AWS HealthScribe 串流是一種以 HTTP2 為基礎的即時雙向服務，在一個頻道上接受音訊串流，並在另一個頻道上提供音訊轉錄。串流完成後， AWS HealthScribe 會分析串流內容，並產生文字記錄 JSON 檔案和臨床備註 JSON 檔案。

 若要開始串流，請使用 [StartMedicalScribeStream](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalScribeStream.html) API 操作。此 API 會啟動 HTTP2 型雙向頻道，讓您用來串流音訊事件。

當您啟動串流時，請先在 中指定串流組態`MedicalScribeConfigurationEvent`。此事件包括頻道定義、加密設定和串流後分析設定，例如彙總文字記錄和產生臨床備註的輸出組態。

開始串流音訊後，您可以管理串流，如下所示：
+  完成後，若要使用串流後分析開始處理結果，請傳送`MedicalScribeSessionControlEvent`具有 `Type` 的 `END_OF_SESSION`， AWS HealthScribe 會開始分析。
+ 若要暫停串流，請完成輸入串流，而不傳送 `MedicalScribeSessionControlEvent`。
+ 若要繼續暫停的串流，請使用 `StartMedicalScribeStream` API 操作並指定相同的 `SessionId`。這是您最初啟動串流`SessionId`時使用的 。

**Topics**
+ [準則和要求](#health-scribe-streaming-requirements)
+ [ResourceAccessRoleArn 角色許可](#health-scribe-data-access-role)
+ [Starting AWS HealthScribe 串流轉錄](health-scribe-streaming-setting-up.md)

## 準則和要求
<a name="health-scribe-streaming-requirements"></a>

以下是 AWS HealthScribe 串流的指導方針和要求：
+ 傳送音訊事件之前，您必須先在 中指定串流組態`[MedicalScribeConfigurationEvent](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_MedicalScribeConfigurationEvent.html)`。
+ 若要執行串流後分析， `ResourceAccessRoleArn`中的 `MedicalScribeConfigurationEvent` 必須具有正確的許可。如需詳細資訊，請參閱[ResourceAccessRoleArn 角色許可](#health-scribe-data-access-role)。
+ 您可以在初始串流建立後 5 小時內繼續工作階段任意次數。
+ 您可以跨所有串流請求透過工作階段串流最多 2 小時的音訊。
+ 根據預設， AWS HealthScribe 提供靜態加密，以保護使用 Amazon S3受管金鑰的敏感客戶資料。當您啟動串流時，您可以為第二層加密指定 AWS KMS 金鑰。您的 `ResourceAccessRoleArn` 必須具有使用 AWS KMS 金鑰的許可。如需詳細資訊，請參閱[for AWS HealthScribe 靜態資料加密](health-scribe-encryption.md)。
+ 您可以使用 AWS HealthScribe 串流搭配 AWS SDKs，不包括適用於 Python (Boto3) 的 SDK 和適用於 PHP 的 SDK。
+ 如果在結束串流後發生`LimitExceededException`例外狀況，您可以重新啟動工作階段，但仍會產生串流後分析。若要重新啟動串流，請使用 [StartMedicalScribeStream](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartMedicalScribeStream.html) API 並使用相同的 `SessionID`。然後傳送`MedicalScribeSessionControlEvent`具有 `Type` 的 `END_OF_SESSION`， AWS HealthScribe 會開始分析。

## ResourceAccessRoleArn 角色許可
<a name="health-scribe-data-access-role"></a>

若要執行串流後分析， `ResourceAccessRoleArn`中的 `MedicalScribeConfigurationEvent` 必須能夠存取您的 Amazon S3 輸出儲存貯體，而且如果您提供它，則必須能夠存取您的 AWS KMS 金鑰。此外，角色的信任政策必須授予`transcribe.streaming.amazonaws.com`服務擔任角色的許可。

以下是授予 Amazon S3 儲存貯體許可和 AWS KMS 金鑰許可的 IAM 政策範例。如需詳細資訊，請參閱[for AWS HealthScribe 靜態資料加密](health-scribe-encryption.md)。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::{{amzn-s3-demo-bucket}}",
                "arn:aws:s3:::{{amzn-s3-demo-bucket}}/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "kms:DescribeKey",
                "kms:Decrypt",
                "kms:Encrypt",
                "kms:GenerateDataKey*"
            ],
            "Resource": "arn:aws:kms:us-west-2:{{123456789012}}:key/{{1234abcd-12ab-34cd-56ef-123456SAMPLE}}",
            "Effect": "Allow"
        }
    ]
}
```

------

信任政策範例如下。

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "transcribe.streaming.amazonaws.com"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

------