버전 4(V4) AWS SDK for .NET 가 릴리스되었습니다.

변경 사항 해제 및 애플리케이션 마이그레이션에 대한 자세한 내용은 [마이그레이션 주제를](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html) 참조하세요.

 [https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 에서 HTTP 2 지원 AWS SDK for .NET
<a name="http2-support"></a>

일부 AWS 서비스 및 작업에는 HTTP 2가 필요합니다. 예를 들어 Amazon Transcribe Streaming의 양방향 스트리밍은 HTTP 1.1을 통해 불가능하므로 대신 HTTP 2가 필요합니다. 애플리케이션에서 이러한 작업을 사용할 수 있도록 HTTP 2에 대한 지원이 버전 4에 AWS SDK for .NET 추가되었습니다. 양방향 HTTP 2 작업의 경우 스트림을 수신할 때 SDK의 동작은 HTTP 1.1의 동작과 유사합니다. 즉, SDK를 사용하는 애플리케이션이 서비스에 이벤트를 전송할 때 요청에는 개발자가 할당한 게시자가 있습니다.

이 동작을 실제로 보려면 Amazon Transcribe Streaming에 대한 다음 예제를 고려하세요. [Amazon.TranscribeStreaming](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/TranscribeStreaming/NTranscribeStreaming.html) 및 [Amazon.TranscribeStreaming.Model](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/TranscribeStreaming/NTranscribeStreamingModel.html) 네임스페이스를 사용합니다.

이 예제에서 개발자는 .NET 인 콜백 함수를 사용하여 `StartStreamTranscriptionRequest.AudioStreamPublisher` 속성을 정의합니다`Func`. SDK는 `AudioStreamPublisher`에 `Func` 정의된를 사용하여 사용자 코드에서 이벤트를 가져와 사용자에게 스트리밍합니다. SDK는 null을 반환할 `Func` 때까지를 호출합니다.

이 코드는 파일의 오디오를 처리를 위해 Amazon Transcribe Streaming으로 스트리밍하는 방법을 보여줍니다.

```
using Amazon;
using Amazon.TranscribeStreaming;
using Amazon.TranscribeStreaming.Model;

CancellationTokenSource cancelSource = new CancellationTokenSource();

var client = new AmazonTranscribeStreamingClient(RegionEndpoint.USEast1);

var startRequest = new StartStreamTranscriptionRequest
{
    LanguageCode = LanguageCode.EnUS,
    MediaEncoding = MediaEncoding.Flac,
    MediaSampleRateHertz = 44100,
    NumberOfChannels = 2,
    EnableChannelIdentification = true
};

Stream fileStream = File.OpenRead("hello-world.flac");
var buffer = new byte[1024 * 10];
startRequest.AudioStreamPublisher += async () =>
{
    var bytesRead = await fileStream.ReadAsync(buffer, 0, buffer.Length);

    if (bytesRead == 0)
        return null;

    var audioEvent = new AudioEvent
    {
        AudioChunk = new MemoryStream(buffer, 0, bytesRead)
    };

    return audioEvent;
};

using var response = await client.StartStreamTranscriptionAsync(startRequest);
Console.WriteLine(response.HttpStatusCode);

response.TranscriptResultStream.ExceptionReceived += TranscriptResultStream_ExceptionReceived;
response.TranscriptResultStream.TranscriptEventReceived += TranscriptResultStream_TranscriptEventReceived;

void TranscriptResultStream_ExceptionReceived(object? sender, Amazon.Runtime.EventStreams.EventStreamExceptionReceivedArgs<TranscribeStreamingEventStreamException> e)
{
    Console.WriteLine(e.EventStreamException.Message);
    cancelSource.Cancel();
}
void TranscriptResultStream_TranscriptEventReceived(object? sender, Amazon.Runtime.EventStreams.EventStreamEventReceivedArgs<TranscriptEvent> e)
{
    foreach (var result in e.EventStreamEvent.Transcript.Results)
    {
        if (!string.Equals("ch_0", result.ChannelId, StringComparison.OrdinalIgnoreCase))
            continue;

        var text = result.Alternatives[0].Transcript;
        if (!string.IsNullOrEmpty(text))
        {
            Console.WriteLine(text);
        }
    }
}

_ = response.TranscriptResultStream.StartProcessingAsync();

try
{
    await Task.Delay(10000, cancelSource.Token);
}
catch (TaskCanceledException) { }
```

**주의**  
Amazon Bedrock의 `InvokeModelWithBidirectionalStreamAsync` 메서드, [Amazon.BedrockRuntime](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/BedrockRuntime/NBedrockRuntime.html) 네임스페이스와 같은 일부 양방향 HTTP 2 작업은 일부 이벤트가 게시될 때까지 서비스 클라이언트의 초기 호출에서 응답을 반환하지 않습니다. 이 동작으로 인해 애플리케이션이 차단될 수 있습니다. 이러한 상황을 방지하려면 게시자에게 이벤트를 제공하는 애플리케이션 코드를 분리하고 서비스 클라이언트에서 작업을 호출하는 스레드와 다른 스레드에서 실행합니다.

## 추가 고려 사항
<a name="http2-support-additional"></a>
+ AWS SDK for .NET HTTP 2에 대한 지원은 .NET 8 이상을 대상으로 하는 버전에서만 사용할 수 있습니다. .NET Framework를 대상으로 하는 버전에서는 사용할 수 없습니다.
+ 자세한 내용은 [aws-sdk-net](https://github.com/aws/aws-sdk-net) GitHub 리포지토리의 [PR 3730](https://github.com/aws/aws-sdk-net/pull/3730)을 참조하세요.