Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS SDKs를 사용하는 Amazon Polly의 코드 예제
다음 코드 예제에서는 Amazon Polly를 AWS 소프트웨어 개발 키트(SDK)와 함께 사용하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접 호출하는 방법을 보여주며, 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
*시나리오*는 동일한 서비스 내에서 또는 다른 AWS 서비스와 결합된 상태에서 여러 함수를 직접적으로 호출하여 특정 태스크를 수행하는 방법을 보여주는 코드 예제입니다.
**추가 리소스**
+ **[Amazon Polly 개발자 가이드](https://docs.aws.amazon.com/polly/latest/dg/what-is.html)** - Amazon Polly에 대한 자세한 정보입니다.
+ **[Amazon Polly API 참조](https://docs.aws.amazon.com/polly/latest/dg/API_Reference.html)** - 사용 가능한 모든 Amazon Polly 작업에 대한 세부 정보입니다.
+ **[AWS 개발자 센터](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23polly)** - 범주 또는 전체 텍스트 검색을 기준으로 필터링할 수 있는 코드 예제입니다.
+ **[AWS SDK 예제](https://github.com/awsdocs/aws-doc-sdk-examples)** - 기본 설정 언어로 된 전체 코드가 포함된 GitHub 리포지토리. 코드 설정 및 실행을 위한 지침이 포함되어 있습니다.
**Contents**
+ [기본 사항](polly_code_examples_basics.md)
+ [작업](polly_code_examples_actions.md)
+ [`DeleteLexicon`](polly_example_polly_DeleteLexicon_section.md)
+ [`DescribeVoices`](polly_example_polly_DescribeVoices_section.md)
+ [`GetLexicon`](polly_example_polly_GetLexicon_section.md)
+ [`GetSpeechSynthesisTask`](polly_example_polly_GetSpeechSynthesisTask_section.md)
+ [`ListLexicons`](polly_example_polly_ListLexicons_section.md)
+ [`ListSpeechSynthesisTasks`](polly_example_polly_ListSpeechSynthesisTasks_section.md)
+ [`PutLexicon`](polly_example_polly_PutLexicon_section.md)
+ [`StartSpeechSynthesisTask`](polly_example_polly_StartSpeechSynthesisTask_section.md)
+ [`SynthesizeSpeech`](polly_example_polly_SynthesizeSpeech_section.md)
+ [시나리오](polly_code_examples_scenarios.md)
+ [텍스트를 스피치로, 다시 스피치에서 텍스트로 변환](polly_example_cross_Telephone_section.md)
+ [립싱크 애플리케이션 생성](polly_example_polly_LipSync_section.md)
+ [고객 피드백 분석을 위한 애플리케이션 생성](polly_example_cross_FSA_section.md)
# AWS SDKs 사용하는 Amazon Polly의 기본 예제
다음 코드 예제에서는 AWS SDK를 통해 Amazon Polly의 기본 기능을 사용하는 방법을 보여줍니다.
**Contents**
+ [작업](polly_code_examples_actions.md)
+ [`DeleteLexicon`](polly_example_polly_DeleteLexicon_section.md)
+ [`DescribeVoices`](polly_example_polly_DescribeVoices_section.md)
+ [`GetLexicon`](polly_example_polly_GetLexicon_section.md)
+ [`GetSpeechSynthesisTask`](polly_example_polly_GetSpeechSynthesisTask_section.md)
+ [`ListLexicons`](polly_example_polly_ListLexicons_section.md)
+ [`ListSpeechSynthesisTasks`](polly_example_polly_ListSpeechSynthesisTasks_section.md)
+ [`PutLexicon`](polly_example_polly_PutLexicon_section.md)
+ [`StartSpeechSynthesisTask`](polly_example_polly_StartSpeechSynthesisTask_section.md)
+ [`SynthesizeSpeech`](polly_example_polly_SynthesizeSpeech_section.md)
# AWS SDKs를 사용하는 Amazon Polly에 대한 작업
다음 코드 예제에서는 AWS SDKs를 사용하여 개별 Amazon Polly 작업을 수행하는 방법을 보여줍니다. 각 예제에는 GitHub에 대한 링크가 포함되어 있습니다. 여기에서 코드 설정 및 실행에 대한 지침을 찾을 수 있습니다.
Amazon Polly API를 직접적으로 호출하는 이들 발췌문은 컨텍스트에서 실행되어야 하는 더 큰 프로그램에서 발췌한 코드입니다. [AWS SDKs를 사용한 Amazon Polly 시나리오](polly_code_examples_scenarios.md)에서 컨텍스트에 맞는 작업을 볼 수 있습니다.
다음 예제에는 가장 일반적으로 사용되는 작업만 포함되어 있습니다. 전체 목록은 [Amazon Polly API 참조](https://docs.aws.amazon.com/polly/latest/dg/API_Reference.html)에서 확인하세요.
**Topics**
+ [`DeleteLexicon`](polly_example_polly_DeleteLexicon_section.md)
+ [`DescribeVoices`](polly_example_polly_DescribeVoices_section.md)
+ [`GetLexicon`](polly_example_polly_GetLexicon_section.md)
+ [`GetSpeechSynthesisTask`](polly_example_polly_GetSpeechSynthesisTask_section.md)
+ [`ListLexicons`](polly_example_polly_ListLexicons_section.md)
+ [`ListSpeechSynthesisTasks`](polly_example_polly_ListSpeechSynthesisTasks_section.md)
+ [`PutLexicon`](polly_example_polly_PutLexicon_section.md)
+ [`StartSpeechSynthesisTask`](polly_example_polly_StartSpeechSynthesisTask_section.md)
+ [`SynthesizeSpeech`](polly_example_polly_SynthesizeSpeech_section.md)
# AWS SDK 또는 CLI와 `DeleteLexicon` 함께 사용
다음 코드 예시는 `DeleteLexicon`의 사용 방법을 보여 줍니다.
------
#### [ .NET ]
**SDK for .NET**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
using System;
using System.Threading.Tasks;
using Amazon.Polly;
using Amazon.Polly.Model;
///
/// Deletes an existing Amazon Polly lexicon using the AWS SDK for .NET.
///
public class DeleteLexicon
{
public static async Task Main()
{
string lexiconName = "SampleLexicon";
var client = new AmazonPollyClient();
var success = await DeletePollyLexiconAsync(client, lexiconName);
if (success)
{
Console.WriteLine($"Successfully deleted {lexiconName}.");
}
else
{
Console.WriteLine($"Could not delete {lexiconName}.");
}
}
///
/// Deletes the named Amazon Polly lexicon.
///
/// The initialized Amazon Polly client object.
/// The name of the Amazon Polly lexicon to
/// delete.
/// A Boolean value indicating the success of the operation.
public static async Task DeletePollyLexiconAsync(
AmazonPollyClient client,
string lexiconName)
{
var deleteLexiconRequest = new DeleteLexiconRequest()
{
Name = lexiconName,
};
var response = await client.DeleteLexiconAsync(deleteLexiconRequest);
return response.HttpStatusCode == System.Net.HttpStatusCode.OK;
}
}
```
+ API 세부 정보는 *AWS SDK for .NET API 참조*의 [DeleteLexicon](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/DeleteLexicon)을 참조하세요.
------
#### [ CLI ]
**AWS CLI**
**어휘를 삭제하는 방법**
다음 `delete-lexicon` 예시에서는 지정된 어휘를 삭제합니다.
```
aws polly delete-lexicon \
--name w3c
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Polly 개발자 안내서*의 [DeleteLexicon 작업 사용](https://docs.aws.amazon.com/polly/latest/dg/gs-delete-lexicon.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DeleteLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/delete-lexicon.html)을 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
lo_ply->deletelexicon( iv_name ).
MESSAGE 'Lexicon deleted successfully.' TYPE 'I'.
CATCH /aws1/cx_plylexiconnotfoundex.
MESSAGE 'Lexicon not found.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 *AWS SDK for SAP ABAP API 참조*의 [DeleteLexicon](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)을 참조하세요.
------
# AWS SDK와 `DescribeVoices` 함께 사용
다음 코드 예시는 `DescribeVoices`의 사용 방법을 보여 줍니다.
------
#### [ .NET ]
**SDK for .NET**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
using System;
using System.Threading.Tasks;
using Amazon.Polly;
using Amazon.Polly.Model;
public class DescribeVoices
{
public static async Task Main()
{
var client = new AmazonPollyClient();
var allVoicesRequest = new DescribeVoicesRequest();
var enUsVoicesRequest = new DescribeVoicesRequest()
{
LanguageCode = "en-US",
};
try
{
string nextToken;
do
{
var allVoicesResponse = await client.DescribeVoicesAsync(allVoicesRequest);
nextToken = allVoicesResponse.NextToken;
allVoicesRequest.NextToken = nextToken;
Console.WriteLine("\nAll voices: ");
allVoicesResponse.Voices.ForEach(voice =>
{
DisplayVoiceInfo(voice);
});
}
while (nextToken is not null);
do
{
var enUsVoicesResponse = await client.DescribeVoicesAsync(enUsVoicesRequest);
nextToken = enUsVoicesResponse.NextToken;
enUsVoicesRequest.NextToken = nextToken;
Console.WriteLine("\nen-US voices: ");
enUsVoicesResponse.Voices.ForEach(voice =>
{
DisplayVoiceInfo(voice);
});
}
while (nextToken is not null);
}
catch (Exception ex)
{
Console.WriteLine("Exception caught: " + ex.Message);
}
}
public static void DisplayVoiceInfo(Voice voice)
{
Console.WriteLine($" Name: {voice.Name}\tGender: {voice.Gender}\tLanguageName: {voice.LanguageName}");
}
}
```
+ API 세부 정보는 *AWS SDK for .NET API 참조*의 [DescribeVoices](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/DescribeVoices)를 참조하십시오.
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.polly.PollyClient;
import software.amazon.awssdk.services.polly.model.DescribeVoicesRequest;
import software.amazon.awssdk.services.polly.model.DescribeVoicesResponse;
import software.amazon.awssdk.services.polly.model.PollyException;
import software.amazon.awssdk.services.polly.model.Voice;
import java.util.List;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class DescribeVoicesSample {
public static void main(String args[]) {
PollyClient polly = PollyClient.builder()
.region(Region.US_WEST_2)
.build();
describeVoice(polly);
polly.close();
}
public static void describeVoice(PollyClient polly) {
try {
DescribeVoicesRequest voicesRequest = DescribeVoicesRequest.builder()
.languageCode("en-US")
.build();
DescribeVoicesResponse enUsVoicesResult = polly.describeVoices(voicesRequest);
List voices = enUsVoicesResult.voices();
for (Voice myVoice : voices) {
System.out.println("The ID of the voice is " + myVoice.id());
System.out.println("The gender of the voice is " + myVoice.gender());
}
} catch (PollyException e) {
System.err.println("Exception caught: " + e);
System.exit(1);
}
}
}
```
+ API 세부 정보는 *AWS SDK for Java 2.x API 참조*의 [DescribeVoices](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices)를 참조하십시오.
------
#### [ Python ]
**SDK for Python (Boto3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
class PollyWrapper:
"""Encapsulates Amazon Polly functions."""
def __init__(self, polly_client, s3_resource):
"""
:param polly_client: A Boto3 Amazon Polly client.
:param s3_resource: A Boto3 Amazon Simple Storage Service (Amazon S3) resource.
"""
self.polly_client = polly_client
self.s3_resource = s3_resource
self.voice_metadata = None
def describe_voices(self):
"""
Gets metadata about available voices.
:return: The list of voice metadata.
"""
try:
response = self.polly_client.describe_voices()
self.voice_metadata = response["Voices"]
logger.info("Got metadata about %s voices.", len(self.voice_metadata))
except ClientError:
logger.exception("Couldn't get voice metadata.")
raise
else:
return self.voice_metadata
```
+ API 세부 정보는 *AWS SDK for Python (Boto3) API 참조*의 [DescribeVoices](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices)를 참조하세요.
------
#### [ Ruby ]
**SDK for Ruby**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
require 'aws-sdk-polly' # In v2: require 'aws-sdk'
begin
# Create an Amazon Polly client using
# credentials from the shared credentials file ~/.aws/credentials
# and the configuration (region) from the shared configuration file ~/.aws/config
polly = Aws::Polly::Client.new
# Get US English voices
resp = polly.describe_voices(language_code: 'en-US')
resp.voices.each do |v|
puts v.name
puts " #{v.gender}"
puts
end
rescue StandardError => e
puts 'Could not get voices'
puts 'Error message:'
puts e.message
end
```
+ API에 대한 세부 정보는 *AWS SDK for Ruby API 참조*의 [DescribeVoices](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices)를 참조하세요.
------
#### [ Rust ]
**SDK for Rust**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
async fn list_voices(client: &Client) -> Result<(), Error> {
let resp = client.describe_voices().send().await?;
println!("Voices:");
let voices = resp.voices();
for voice in voices {
println!(" Name: {}", voice.name().unwrap_or("No name!"));
println!(
" Language: {}",
voice.language_name().unwrap_or("No language!")
);
println!();
}
println!("Found {} voices", voices.len());
Ok(())
}
```
+ API 세부 정보는 *AWS SDK for Rust API 참조*의 [DescribeVoices](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.describe_voices)를 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
" Only pass optional parameters if they have values
IF iv_engine IS NOT INITIAL AND iv_language IS NOT INITIAL.
oo_result = lo_ply->describevoices(
iv_engine = iv_engine
iv_languagecode = iv_language ).
ELSEIF iv_engine IS NOT INITIAL.
oo_result = lo_ply->describevoices(
iv_engine = iv_engine ).
ELSEIF iv_language IS NOT INITIAL.
oo_result = lo_ply->describevoices(
iv_languagecode = iv_language ).
ELSE.
oo_result = lo_ply->describevoices( ).
ENDIF.
MESSAGE 'Retrieved voice metadata.' TYPE 'I'.
CATCH /aws1/cx_plyinvalidnexttokenex.
MESSAGE 'The NextToken is invalid.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 *AWS SDK for SAP ABAP API 참조*의 [DescribeVoices](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)를 참조하세요.
------
# AWS SDK 또는 CLI와 `GetLexicon` 함께 사용
다음 코드 예시는 `GetLexicon`의 사용 방법을 보여 줍니다.
------
#### [ .NET ]
**SDK for .NET**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
using System;
using System.Threading.Tasks;
using Amazon.Polly;
using Amazon.Polly.Model;
///
/// Retrieves information about a specific Amazon Polly lexicon.
///
public class GetLexicon
{
public static async Task Main(string[] args)
{
string lexiconName = "SampleLexicon";
var client = new AmazonPollyClient();
await GetPollyLexiconAsync(client, lexiconName);
}
public static async Task GetPollyLexiconAsync(AmazonPollyClient client, string lexiconName)
{
var getLexiconRequest = new GetLexiconRequest()
{
Name = lexiconName,
};
try
{
var response = await client.GetLexiconAsync(getLexiconRequest);
Console.WriteLine($"Lexicon:\n Name: {response.Lexicon.Name}");
Console.WriteLine($"Content: {response.Lexicon.Content}");
}
catch (Exception ex)
{
Console.WriteLine("Error: " + ex.Message);
}
}
}
```
+ API 세부 정보는 *AWS SDK for .NET API 참조*의 [GetLexicon](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/GetLexicon)을 참조하세요.
------
#### [ CLI ]
**AWS CLI**
**어휘의 콘텐츠를 검색하는 방법**
다음 `get-lexicon` 예시에서는 지정된 발음 어휘의 콘텐츠를 검색합니다.
```
aws polly get-lexicon \
--name w3c
```
출력:
```
{
"Lexicon": {
"Content": "\n\n \n W3C\n World Wide Web Consortium\n \n\n",
"Name": "w3c"
},
"LexiconAttributes": {
"Alphabet": "ipa",
"LanguageCode": "en-US",
"LastModified": 1603908910.99,
"LexiconArn": "arn:aws:polly:us-west-2:880185128111:lexicon/w3c",
"LexemesCount": 1,
"Size": 492
}
}
```
자세한 내용은 *Amazon Polly 개발자 안내서*의 [GetLexicon 작업 사용](https://docs.aws.amazon.com/polly/latest/dg/gs-get-lexicon.html)을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [GetLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-lexicon.html)을 참조하세요.
------
#### [ Python ]
**SDK for Python(Boto3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
class PollyWrapper:
"""Encapsulates Amazon Polly functions."""
def __init__(self, polly_client, s3_resource):
"""
:param polly_client: A Boto3 Amazon Polly client.
:param s3_resource: A Boto3 Amazon Simple Storage Service (Amazon S3) resource.
"""
self.polly_client = polly_client
self.s3_resource = s3_resource
self.voice_metadata = None
def get_lexicon(self, name):
"""
Gets metadata and contents of an existing lexicon.
:param name: The name of the lexicon to retrieve.
:return: The retrieved lexicon.
"""
try:
response = self.polly_client.get_lexicon(Name=name)
logger.info("Got lexicon %s.", name)
except ClientError:
logger.exception("Couldn't get lexicon %s.", name)
raise
else:
return response
```
+ API 세부 정보는 *AWS SDK for Python (Boto3) API 참조*의 [GetLexicon](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon)를 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
oo_result = lo_ply->getlexicon( iv_name ).
DATA(lo_lexicon) = oo_result->get_lexicon( ).
IF lo_lexicon IS BOUND.
DATA(lv_lex_name) = lo_lexicon->get_name( ).
MESSAGE |Retrieved lexicon: { lv_lex_name }| TYPE 'I'.
ENDIF.
CATCH /aws1/cx_plylexiconnotfoundex.
MESSAGE 'Lexicon not found.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 SDK for SAP ABAP API 참조의 [GetLexicon](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)을 참조하세요. *AWS *
------
# AWS SDK 또는 CLI와 `GetSpeechSynthesisTask` 함께 사용
다음 코드 예시는 `GetSpeechSynthesisTask`의 사용 방법을 보여 줍니다.
------
#### [ CLI ]
**AWS CLI**
**음성 합성 작업 정보 가져오기**
다음 `get-speech-synthesis-task` 예시에서는 지정된 음성 합성 태스크에 대한 정보를 검색합니다.
```
aws polly get-speech-synthesis-task \
--task-id 70b61c0f-57ce-4715-a247-cae8729dcce9
```
출력:
```
{
"SynthesisTask": {
"TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
"TaskStatus": "completed",
"OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
"CreationTime": 1603911042.689,
"RequestCharacters": 1311,
"OutputFormat": "mp3",
"TextType": "text",
"VoiceId": "Joanna"
}
}
```
자세한 내용은 *Amazon Polly 개발자 안내서*의 [긴 오디오 파일 생성](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html)을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [GetSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-speech-synthesis-task.html)를 참조하세요.
------
#### [ Python ]
**SDK for Python(Boto3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
class PollyWrapper:
"""Encapsulates Amazon Polly functions."""
def __init__(self, polly_client, s3_resource):
"""
:param polly_client: A Boto3 Amazon Polly client.
:param s3_resource: A Boto3 Amazon Simple Storage Service (Amazon S3) resource.
"""
self.polly_client = polly_client
self.s3_resource = s3_resource
self.voice_metadata = None
def get_speech_synthesis_task(self, task_id):
"""
Gets metadata about an asynchronous speech synthesis task, such as its status.
:param task_id: The ID of the task to retrieve.
:return: Metadata about the task.
"""
try:
response = self.polly_client.get_speech_synthesis_task(TaskId=task_id)
task = response["SynthesisTask"]
logger.info("Got synthesis task. Status is %s.", task["TaskStatus"])
except ClientError:
logger.exception("Couldn't get synthesis task %s.", task_id)
raise
else:
return task
```
+ API 세부 정보는 *AWS SDK for Python (Boto3) API 참조*의 [GetSpeechSynthesisTask](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask)를 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
oo_result = lo_ply->getspeechsynthesistask( iv_task_id ).
DATA(lo_task) = oo_result->get_synthesistask( ).
IF lo_task IS BOUND.
DATA(lv_status) = lo_task->get_taskstatus( ).
MESSAGE |Task status: { lv_status }| TYPE 'I'.
ENDIF.
CATCH /aws1/cx_plyinvalidtaskidex.
MESSAGE 'Invalid task ID.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
CATCH /aws1/cx_plysynthesistsknotf00.
MESSAGE 'Synthesis task not found.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 SDK for SAP ABAP API 참조의 [GetSpeechSynthesisTask](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)를 참조하세요. *AWS *
------
# AWS SDK 또는 CLI와 `ListLexicons` 함께 사용
다음 코드 예시는 `ListLexicons`의 사용 방법을 보여 줍니다.
------
#### [ .NET ]
**SDK for .NET**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
using System;
using System.Threading.Tasks;
using Amazon.Polly;
using Amazon.Polly.Model;
///
/// Lists the Amazon Polly lexicons that have been defined. By default,
/// lists the lexicons that are defined in the same AWS Region as the default
/// user. To view Amazon Polly lexicons that are defined in a different AWS
/// Region, supply it as a parameter to the Amazon Polly constructor.
///
public class ListLexicons
{
public static async Task Main()
{
var client = new AmazonPollyClient();
var request = new ListLexiconsRequest();
try
{
Console.WriteLine("All voices: ");
do
{
var response = await client.ListLexiconsAsync(request);
request.NextToken = response.NextToken;
response.Lexicons.ForEach(lexicon =>
{
var attributes = lexicon.Attributes;
Console.WriteLine($"Name: {lexicon.Name}");
Console.WriteLine($"\tAlphabet: {attributes.Alphabet}");
Console.WriteLine($"\tLanguageCode: {attributes.LanguageCode}");
Console.WriteLine($"\tLastModified: {attributes.LastModified}");
Console.WriteLine($"\tLexemesCount: {attributes.LexemesCount}");
Console.WriteLine($"\tLexiconArn: {attributes.LexiconArn}");
Console.WriteLine($"\tSize: {attributes.Size}");
});
}
while (request.NextToken is not null);
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
```
+ API에 대한 세부 정보는 *AWS SDK for .NET API 참조*의 [ListLexicons](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/ListLexicons)를 참조하세요.
------
#### [ CLI ]
**AWS CLI**
**어휘를 나열하는 방법**
다음 `list-lexicons` 예시에서는 발음 어휘를 나열합니다.
```
aws polly list-lexicons
```
출력:
```
{
"Lexicons": [
{
"Name": "w3c",
"Attributes": {
"Alphabet": "ipa",
"LanguageCode": "en-US",
"LastModified": 1603908910.99,
"LexiconArn": "arn:aws:polly:us-east-2:123456789012:lexicon/w3c",
"LexemesCount": 1,
"Size": 492
}
}
]
}
```
자세한 내용은 *Amazon Polly 개발자 안내서*의 [ListLexicons 작업 사용](https://docs.aws.amazon.com/polly/latest/dg/gs-list-lexicons.html)을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [ListLexicons](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-lexicons.html)을 참조하세요.
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.polly.PollyClient;
import software.amazon.awssdk.services.polly.model.ListLexiconsResponse;
import software.amazon.awssdk.services.polly.model.ListLexiconsRequest;
import software.amazon.awssdk.services.polly.model.LexiconDescription;
import software.amazon.awssdk.services.polly.model.PollyException;
import java.util.List;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class ListLexicons {
public static void main(String args[]) {
PollyClient polly = PollyClient.builder()
.region(Region.US_WEST_2)
.build();
listLexicons(polly);
polly.close();
}
public static void listLexicons(PollyClient client) {
try {
ListLexiconsRequest listLexiconsRequest = ListLexiconsRequest.builder()
.build();
ListLexiconsResponse listLexiconsResult = client.listLexicons(listLexiconsRequest);
List lexiconDescription = listLexiconsResult.lexicons();
for (LexiconDescription lexDescription : lexiconDescription) {
System.out.println("The name of the Lexicon is " + lexDescription.name());
}
} catch (PollyException e) {
System.err.println("Exception caught: " + e);
System.exit(1);
}
}
}
```
+ API 세부 정보는 *AWS SDK for Java 2.x API 참조*의 [ListLexicons](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons)를 참조하십시오.
------
#### [ Python ]
**SDK for Python (Boto3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
class PollyWrapper:
"""Encapsulates Amazon Polly functions."""
def __init__(self, polly_client, s3_resource):
"""
:param polly_client: A Boto3 Amazon Polly client.
:param s3_resource: A Boto3 Amazon Simple Storage Service (Amazon S3) resource.
"""
self.polly_client = polly_client
self.s3_resource = s3_resource
self.voice_metadata = None
def list_lexicons(self):
"""
Lists lexicons in the current account.
:return: The list of lexicons.
"""
try:
response = self.polly_client.list_lexicons()
lexicons = response["Lexicons"]
logger.info("Got %s lexicons.", len(lexicons))
except ClientError:
logger.exception(
"Couldn't get %s.",
)
raise
else:
return lexicons
```
+ API 세부 정보는 *AWS SDK for Python (Boto3) API 참조*의 [ListLexicons](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons)를 참조하세요.
------
#### [ Ruby ]
**SDK for Ruby**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
require 'aws-sdk-polly' # In v2: require 'aws-sdk'
begin
# Create an Amazon Polly client using
# credentials from the shared credentials file ~/.aws/credentials
# and the configuration (region) from the shared configuration file ~/.aws/config
polly = Aws::Polly::Client.new
resp = polly.list_lexicons
resp.lexicons.each do |l|
puts l.name
puts " Alphabet:#{l.attributes.alphabet}"
puts " Language:#{l.attributes.language}"
puts
end
rescue StandardError => e
puts 'Could not get lexicons'
puts 'Error message:'
puts e.message
end
```
+ API에 대한 세부 정보는 *AWS SDK for Ruby API 참조*의 [ListLexicons](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons)를 참조하세요.
------
#### [ Rust ]
**SDK for Rust**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
async fn show_lexicons(client: &Client) -> Result<(), Error> {
let resp = client.list_lexicons().send().await?;
println!("Lexicons:");
let lexicons = resp.lexicons();
for lexicon in lexicons {
println!(" Name: {}", lexicon.name().unwrap_or_default());
println!(
" Language: {:?}\n",
lexicon
.attributes()
.as_ref()
.map(|attrib| attrib
.language_code
.as_ref()
.expect("languages must have language codes"))
.expect("languages must have attributes")
);
}
println!();
println!("Found {} lexicons.", lexicons.len());
println!();
Ok(())
}
```
+ API 세부 정보는 *AWS SDK for Rust API 참조*의 [ListLexicons](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.list_lexicons)를 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
oo_result = lo_ply->listlexicons( ).
DATA(lt_lexicons) = oo_result->get_lexicons( ).
DATA(lv_count) = lines( lt_lexicons ).
MESSAGE |Found { lv_count } lexicons| TYPE 'I'.
CATCH /aws1/cx_plyinvalidnexttokenex.
MESSAGE 'Invalid NextToken.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 *AWS SDK for SAP ABAP API 참조*의 [ListLexicons](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)를 참조하세요.
------
# AWS SDK 또는 CLI와 `ListSpeechSynthesisTasks` 함께 사용
다음 코드 예시는 `ListSpeechSynthesisTasks`의 사용 방법을 보여 줍니다.
------
#### [ CLI ]
**AWS CLI**
**음성 합성 작업 나열**
다음 `list-speech-synthesis-tasks` 예시에서는 음성 합성 작업을 나열합니다.
```
aws polly list-speech-synthesis-tasks
```
출력:
```
{
"SynthesisTasks": [
{
"TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
"TaskStatus": "completed",
"OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
"CreationTime": 1603911042.689,
"RequestCharacters": 1311,
"OutputFormat": "mp3",
"TextType": "text",
"VoiceId": "Joanna"
}
]
}
```
자세한 내용은 *Amazon Polly 개발자 안내서*의 [긴 오디오 파일 생성](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListSpeechSynthesisTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-speech-synthesis-tasks.html)를 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
" Only pass optional parameters if they have values
IF iv_max_results IS NOT INITIAL AND iv_status IS NOT INITIAL.
oo_result = lo_ply->listspeechsynthesistasks(
iv_maxresults = iv_max_results
iv_status = iv_status ).
ELSEIF iv_max_results IS NOT INITIAL.
oo_result = lo_ply->listspeechsynthesistasks(
iv_maxresults = iv_max_results ).
ELSEIF iv_status IS NOT INITIAL.
oo_result = lo_ply->listspeechsynthesistasks(
iv_status = iv_status ).
ELSE.
oo_result = lo_ply->listspeechsynthesistasks( ).
ENDIF.
DATA(lt_tasks) = oo_result->get_synthesistasks( ).
DATA(lv_count) = lines( lt_tasks ).
MESSAGE |Found { lv_count } synthesis tasks| TYPE 'I'.
CATCH /aws1/cx_plyinvalidnexttokenex.
MESSAGE 'Invalid NextToken.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 SDK for SAP ABAP API 참조의 [ListSpeechSynthesisTasks](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)를 참조하세요. *AWS *
------
# AWS SDK 또는 CLI와 `PutLexicon` 함께 사용
다음 코드 예시는 `PutLexicon`의 사용 방법을 보여 줍니다.
------
#### [ .NET ]
**SDK for .NET**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
using System;
using System.Threading.Tasks;
using Amazon.Polly;
using Amazon.Polly.Model;
///
/// Creates a new Amazon Polly lexicon using the AWS SDK for .NET.
///
public class PutLexicon
{
public static async Task Main()
{
string lexiconContent = "" +
"" +
"test1test2" +
"";
string lexiconName = "SampleLexicon";
var client = new AmazonPollyClient();
var putLexiconRequest = new PutLexiconRequest()
{
Name = lexiconName,
Content = lexiconContent,
};
try
{
var response = await client.PutLexiconAsync(putLexiconRequest);
if (response.HttpStatusCode == System.Net.HttpStatusCode.OK)
{
Console.WriteLine($"Successfully created Lexicon: {lexiconName}.");
}
else
{
Console.WriteLine($"Could not create Lexicon: {lexiconName}.");
}
}
catch (Exception ex)
{
Console.WriteLine("Exception caught: " + ex.Message);
}
}
}
```
+ API 세부 정보는 *AWS SDK for .NET API 참조*의 [PutLexicon](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/PutLexicon)을 참조하세요.
------
#### [ CLI ]
**AWS CLI**
**어휘를 저장하는 방법**
다음 `put-lexicon` 예시에서는 지정된 발음 어휘를 저장합니다. `example.pls` 파일은 W3C PLS 호환 어휘를 지정합니다.
```
aws polly put-lexicon \
--name w3c \
--content file://example.pls
```
`example.pls`의 콘텐츠
```
{
W3C
World Wide Web Consortium
}
```
이 명령은 출력을 생성하지 않습니다.
자세한 내용은 *Amazon Polly 개발자 안내서*의 [PutLexicon 작업 사용](https://docs.aws.amazon.com/polly/latest/dg/gs-put-lexicon.html)을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [PutLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/put-lexicon.html)을 참조하세요.
------
#### [ Python ]
**SDK for Python(Boto3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
class PollyWrapper:
"""Encapsulates Amazon Polly functions."""
def __init__(self, polly_client, s3_resource):
"""
:param polly_client: A Boto3 Amazon Polly client.
:param s3_resource: A Boto3 Amazon Simple Storage Service (Amazon S3) resource.
"""
self.polly_client = polly_client
self.s3_resource = s3_resource
self.voice_metadata = None
def create_lexicon(self, name, content):
"""
Creates a lexicon with the specified content. A lexicon contains custom
pronunciations.
:param name: The name of the lexicon.
:param content: The content of the lexicon.
"""
try:
self.polly_client.put_lexicon(Name=name, Content=content)
logger.info("Created lexicon %s.", name)
except ClientError:
logger.exception("Couldn't create lexicon %s.")
raise
```
+ API 세부 정보는 *AWS SDK for Python (Boto3) API 참조*의 [PutLexicon](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon)을 참조하십시오.
------
#### [ Rust ]
**SDK for Rust**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
async fn make_lexicon(client: &Client, name: &str, from: &str, to: &str) -> Result<(), Error> {
let content = format!("
{}{}
", from, to);
client
.put_lexicon()
.name(name)
.content(content)
.send()
.await?;
println!("Added lexicon");
Ok(())
}
```
+ API 세부 정보는 *AWS SDK for Rust API 참조*의 [PutLexicon](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.put_lexicon)을 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
lo_ply->putlexicon(
iv_name = iv_name
iv_content = iv_content ).
MESSAGE 'Lexicon created successfully.' TYPE 'I'.
CATCH /aws1/cx_plyinvalidlexiconex.
MESSAGE 'Invalid lexicon.' TYPE 'E'.
CATCH /aws1/cx_plylexiconsizeexcdex.
MESSAGE 'Lexicon size exceeded.' TYPE 'E'.
CATCH /aws1/cx_plymaxlexemelengthe00.
MESSAGE 'Maximum lexeme length exceeded.' TYPE 'E'.
CATCH /aws1/cx_plymaxlexiconsnoexc00.
MESSAGE 'Maximum number of lexicons exceeded.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
CATCH /aws1/cx_plyunsuppedplsalpha00.
MESSAGE 'Unsupported PLS alphabet.' TYPE 'E'.
CATCH /aws1/cx_plyunsuppedplslangu00.
MESSAGE 'Unsupported PLS language.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 *AWS SDK for SAP ABAP API 참조*의 [PutLexicon](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)을 참조하세요.
------
# AWS SDK 또는 CLI와 `StartSpeechSynthesisTask` 함께 사용
다음 코드 예시는 `StartSpeechSynthesisTask`의 사용 방법을 보여 줍니다.
------
#### [ CLI ]
**AWS CLI**
**텍스트 합성**
다음 `start-speech-synthesis-task` 예시에서는 `text_file.txt`의 텍스트를 합성하고 결과 MP3 파일을 지정된 버킷에 저장합니다.
```
aws polly start-speech-synthesis-task \
--output-format mp3 \
--output-s3-bucket-name amzn-s3-demo-bucket \
--text file://text_file.txt \
--voice-id Joanna
```
출력:
```
{
"SynthesisTask": {
"TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
"TaskStatus": "scheduled",
"OutputUri": "https://s3.us-east-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
"CreationTime": 1603911042.689,
"RequestCharacters": 1311,
"OutputFormat": "mp3",
"TextType": "text",
"VoiceId": "Joanna"
}
}
```
자세한 내용은 *Amazon Polly 개발자 안내서*의 [긴 오디오 파일 생성](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html)을 참조하세요.
+ API 세부 정보는 **AWS CLI 명령 참조의 [StartSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/start-speech-synthesis-task.html)를 참조하세요.
------
#### [ Python ]
**SDK for Python(Boto3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
class PollyWrapper:
"""Encapsulates Amazon Polly functions."""
def __init__(self, polly_client, s3_resource):
"""
:param polly_client: A Boto3 Amazon Polly client.
:param s3_resource: A Boto3 Amazon Simple Storage Service (Amazon S3) resource.
"""
self.polly_client = polly_client
self.s3_resource = s3_resource
self.voice_metadata = None
def do_synthesis_task(
self,
text,
engine,
voice,
audio_format,
s3_bucket,
lang_code=None,
include_visemes=False,
wait_callback=None,
):
"""
Start an asynchronous task to synthesize speech or speech marks, wait for
the task to complete, retrieve the output from Amazon S3, and return the
data.
An asynchronous task is required when the text is too long for near-real time
synthesis.
:param text: The text to synthesize.
:param engine: The kind of engine used. Can be standard or neural.
:param voice: The ID of the voice to use.
:param audio_format: The audio format to return for synthesized speech. When
speech marks are synthesized, the output format is JSON.
:param s3_bucket: The name of an existing Amazon S3 bucket that you have
write access to. Synthesis output is written to this bucket.
:param lang_code: The language code of the voice to use. This has an effect
only when a bilingual voice is selected.
:param include_visemes: When True, a second request is made to Amazon Polly
to synthesize a list of visemes, using the specified
text and voice. A viseme represents the visual position
of the face and mouth when saying part of a word.
:param wait_callback: A callback function that is called periodically during
task processing, to give the caller an opportunity to
take action, such as to display status.
:return: The audio stream that contains the synthesized speech and a list
of visemes that are associated with the speech audio.
"""
try:
kwargs = {
"Engine": engine,
"OutputFormat": audio_format,
"OutputS3BucketName": s3_bucket,
"Text": text,
"VoiceId": voice,
}
if lang_code is not None:
kwargs["LanguageCode"] = lang_code
response = self.polly_client.start_speech_synthesis_task(**kwargs)
speech_task = response["SynthesisTask"]
logger.info("Started speech synthesis task %s.", speech_task["TaskId"])
viseme_task = None
if include_visemes:
kwargs["OutputFormat"] = "json"
kwargs["SpeechMarkTypes"] = ["viseme"]
response = self.polly_client.start_speech_synthesis_task(**kwargs)
viseme_task = response["SynthesisTask"]
logger.info("Started viseme synthesis task %s.", viseme_task["TaskId"])
except ClientError:
logger.exception("Couldn't start synthesis task.")
raise
else:
bucket = self.s3_resource.Bucket(s3_bucket)
audio_stream = self._wait_for_task(
10, speech_task["TaskId"], "speech", wait_callback, bucket
)
visemes = None
if include_visemes:
viseme_data = self._wait_for_task(
10, viseme_task["TaskId"], "viseme", wait_callback, bucket
)
visemes = [
json.loads(v) for v in viseme_data.read().decode().split() if v
]
return audio_stream, visemes
```
+ API 세부 정보는 *AWS SDK for Python (Boto3) API 참조*의 [StartSpeechSynthesisTask](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask)를 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
" Only pass optional parameters if they have values
IF iv_lang_code IS NOT INITIAL AND iv_s3_key_prefix IS NOT INITIAL.
oo_result = lo_ply->startspeechsynthesistask(
iv_engine = iv_engine
iv_outputformat = iv_audio_format
iv_outputs3bucketname = iv_s3_bucket
iv_outputs3keyprefix = iv_s3_key_prefix
iv_text = iv_text
iv_voiceid = iv_voice_id
iv_languagecode = iv_lang_code ).
ELSEIF iv_lang_code IS NOT INITIAL.
oo_result = lo_ply->startspeechsynthesistask(
iv_engine = iv_engine
iv_outputformat = iv_audio_format
iv_outputs3bucketname = iv_s3_bucket
iv_text = iv_text
iv_voiceid = iv_voice_id
iv_languagecode = iv_lang_code ).
ELSEIF iv_s3_key_prefix IS NOT INITIAL.
oo_result = lo_ply->startspeechsynthesistask(
iv_engine = iv_engine
iv_outputformat = iv_audio_format
iv_outputs3bucketname = iv_s3_bucket
iv_outputs3keyprefix = iv_s3_key_prefix
iv_text = iv_text
iv_voiceid = iv_voice_id ).
ELSE.
oo_result = lo_ply->startspeechsynthesistask(
iv_engine = iv_engine
iv_outputformat = iv_audio_format
iv_outputs3bucketname = iv_s3_bucket
iv_text = iv_text
iv_voiceid = iv_voice_id ).
ENDIF.
MESSAGE 'Speech synthesis task started.' TYPE 'I'.
CATCH /aws1/cx_plyinvalids3bucketex.
MESSAGE 'Invalid S3 bucket.' TYPE 'E'.
CATCH /aws1/cx_plyinvalidssmlex.
MESSAGE 'Invalid SSML.' TYPE 'E'.
CATCH /aws1/cx_plylexiconnotfoundex.
MESSAGE 'Lexicon not found.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
CATCH /aws1/cx_plytextlengthexcdex.
MESSAGE 'Text length exceeded maximum.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 SDK for SAP ABAP API 참조의 [StartSpeechSynthesisTask](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)를 참조하세요. *AWS *
------
# AWS SDK와 `SynthesizeSpeech` 함께 사용
다음 코드 예시는 `SynthesizeSpeech`의 사용 방법을 보여 줍니다.
------
#### [ .NET ]
**SDK for .NET**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
using System;
using System.IO;
using System.Threading.Tasks;
using Amazon.Polly;
using Amazon.Polly.Model;
public class SynthesizeSpeech
{
public static async Task Main()
{
string outputFileName = "speech.mp3";
string text = "Twas brillig, and the slithy toves did gyre and gimbol in the wabe";
var client = new AmazonPollyClient();
var response = await PollySynthesizeSpeech(client, text);
WriteSpeechToStream(response.AudioStream, outputFileName);
}
///
/// Calls the Amazon Polly SynthesizeSpeechAsync method to convert text
/// to speech.
///
/// The Amazon Polly client object used to connect
/// to the Amazon Polly service.
/// The text to convert to speech.
/// A SynthesizeSpeechResponse object that includes an AudioStream
/// object with the converted text.
private static async Task PollySynthesizeSpeech(IAmazonPolly client, string text)
{
var synthesizeSpeechRequest = new SynthesizeSpeechRequest()
{
OutputFormat = OutputFormat.Mp3,
VoiceId = VoiceId.Joanna,
Text = text,
};
var synthesizeSpeechResponse =
await client.SynthesizeSpeechAsync(synthesizeSpeechRequest);
return synthesizeSpeechResponse;
}
///
/// Writes the AudioStream returned from the call to
/// SynthesizeSpeechAsync to a file in MP3 format.
///
/// The AudioStream returned from the
/// call to the SynthesizeSpeechAsync method.
/// The full path to the file in which to
/// save the audio stream.
private static void WriteSpeechToStream(Stream audioStream, string outputFileName)
{
var outputStream = new FileStream(
outputFileName,
FileMode.Create,
FileAccess.Write);
byte[] buffer = new byte[2 * 1024];
int readBytes;
while ((readBytes = audioStream.Read(buffer, 0, 2 * 1024)) > 0)
{
outputStream.Write(buffer, 0, readBytes);
}
// Flushes the buffer to avoid losing the last second or so of
// the synthesized text.
outputStream.Flush();
Console.WriteLine($"Saved {outputFileName} to disk.");
}
}
```
AWS SDK를 사용하여 Amazon Polly에서 스피치 마크를 사용하여 텍스트의 스피치를 합성합니다.
```
using System;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using Amazon.Polly;
using Amazon.Polly.Model;
public class SynthesizeSpeechMarks
{
public static async Task Main()
{
var client = new AmazonPollyClient();
string outputFileName = "speechMarks.json";
var synthesizeSpeechRequest = new SynthesizeSpeechRequest()
{
OutputFormat = OutputFormat.Json,
SpeechMarkTypes = new List
{
SpeechMarkType.Viseme,
SpeechMarkType.Word,
},
VoiceId = VoiceId.Joanna,
Text = "This is a sample text to be synthesized.",
};
try
{
using (var outputStream = new FileStream(outputFileName, FileMode.Create, FileAccess.Write))
{
var synthesizeSpeechResponse = await client.SynthesizeSpeechAsync(synthesizeSpeechRequest);
var buffer = new byte[2 * 1024];
int readBytes;
var inputStream = synthesizeSpeechResponse.AudioStream;
while ((readBytes = inputStream.Read(buffer, 0, 2 * 1024)) > 0)
{
outputStream.Write(buffer, 0, readBytes);
}
}
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
```
+ API에 대한 자세한 내용은 *AWS SDK for .NET API 참조*의 [SynthizeSpeech](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/SynthesizeSpeech)를 참조하십시오.
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
import javazoom.jl.decoder.JavaLayerException;
import software.amazon.awssdk.core.ResponseInputStream;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.polly.PollyClient;
import software.amazon.awssdk.services.polly.model.DescribeVoicesRequest;
import software.amazon.awssdk.services.polly.model.Voice;
import software.amazon.awssdk.services.polly.model.DescribeVoicesResponse;
import software.amazon.awssdk.services.polly.model.OutputFormat;
import software.amazon.awssdk.services.polly.model.PollyException;
import software.amazon.awssdk.services.polly.model.SynthesizeSpeechRequest;
import software.amazon.awssdk.services.polly.model.SynthesizeSpeechResponse;
import java.io.IOException;
import java.io.InputStream;
import javazoom.jl.player.advanced.AdvancedPlayer;
import javazoom.jl.player.advanced.PlaybackEvent;
import javazoom.jl.player.advanced.PlaybackListener;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class PollyDemo {
private static final String SAMPLE = "Congratulations. You have successfully built this working demo " +
" of Amazon Polly in Java Version 2. Have fun building voice enabled apps with Amazon Polly (that's me!), and always "
+
" look at the AWS website for tips and tricks on using Amazon Polly and other great services from AWS";
public static void main(String args[]) {
PollyClient polly = PollyClient.builder()
.region(Region.US_WEST_2)
.build();
talkPolly(polly);
polly.close();
}
public static void talkPolly(PollyClient polly) {
try {
DescribeVoicesRequest describeVoiceRequest = DescribeVoicesRequest.builder()
.engine("standard")
.build();
DescribeVoicesResponse describeVoicesResult = polly.describeVoices(describeVoiceRequest);
Voice voice = describeVoicesResult.voices().stream()
.filter(v -> v.name().equals("Joanna"))
.findFirst()
.orElseThrow(() -> new RuntimeException("Voice not found"));
InputStream stream = synthesize(polly, SAMPLE, voice, OutputFormat.MP3);
AdvancedPlayer player = new AdvancedPlayer(stream,
javazoom.jl.player.FactoryRegistry.systemRegistry().createAudioDevice());
player.setPlayBackListener(new PlaybackListener() {
public void playbackStarted(PlaybackEvent evt) {
System.out.println("Playback started");
System.out.println(SAMPLE);
}
public void playbackFinished(PlaybackEvent evt) {
System.out.println("Playback finished");
}
});
// play it!
player.play();
} catch (PollyException | JavaLayerException | IOException e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static InputStream synthesize(PollyClient polly, String text, Voice voice, OutputFormat format)
throws IOException {
SynthesizeSpeechRequest synthReq = SynthesizeSpeechRequest.builder()
.text(text)
.voiceId(voice.id())
.outputFormat(format)
.build();
ResponseInputStream synthRes = polly.synthesizeSpeech(synthReq);
return synthRes;
}
}
```
+ API에 대한 자세한 내용은 *AWS SDK for Java 2.x API 참조*의 [SynthizeSpeech](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech)를 참조하십시오.
------
#### [ Python ]
**SDK for Python (Boto3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
class PollyWrapper:
"""Encapsulates Amazon Polly functions."""
def __init__(self, polly_client, s3_resource):
"""
:param polly_client: A Boto3 Amazon Polly client.
:param s3_resource: A Boto3 Amazon Simple Storage Service (Amazon S3) resource.
"""
self.polly_client = polly_client
self.s3_resource = s3_resource
self.voice_metadata = None
def synthesize(
self, text, engine, voice, audio_format, lang_code=None, include_visemes=False
):
"""
Synthesizes speech or speech marks from text, using the specified voice.
:param text: The text to synthesize.
:param engine: The kind of engine used. Can be standard or neural.
:param voice: The ID of the voice to use.
:param audio_format: The audio format to return for synthesized speech. When
speech marks are synthesized, the output format is JSON.
:param lang_code: The language code of the voice to use. This has an effect
only when a bilingual voice is selected.
:param include_visemes: When True, a second request is made to Amazon Polly
to synthesize a list of visemes, using the specified
text and voice. A viseme represents the visual position
of the face and mouth when saying part of a word.
:return: The audio stream that contains the synthesized speech and a list
of visemes that are associated with the speech audio.
"""
try:
kwargs = {
"Engine": engine,
"OutputFormat": audio_format,
"Text": text,
"VoiceId": voice,
}
if lang_code is not None:
kwargs["LanguageCode"] = lang_code
response = self.polly_client.synthesize_speech(**kwargs)
audio_stream = response["AudioStream"]
logger.info("Got audio stream spoken by %s.", voice)
visemes = None
if include_visemes:
kwargs["OutputFormat"] = "json"
kwargs["SpeechMarkTypes"] = ["viseme"]
response = self.polly_client.synthesize_speech(**kwargs)
visemes = [
json.loads(v)
for v in response["AudioStream"].read().decode().split()
if v
]
logger.info("Got %s visemes.", len(visemes))
except ClientError:
logger.exception("Couldn't get audio stream.")
raise
else:
return audio_stream, visemes
```
+ API 세부 정보는 *AWS SDK for Python (Boto3) API 참조*의 [SynthesizeSpeech](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech)를 참조하세요.
------
#### [ Ruby ]
**SDK for Ruby**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/example_code/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
require 'aws-sdk-polly' # In v2: require 'aws-sdk'
begin
# Get the filename from the command line
if ARGV.empty?
puts 'You must supply a filename'
exit 1
end
filename = ARGV[0]
# Open file and get the contents as a string
if File.exist?(filename)
contents = IO.read(filename)
else
puts "No such file: #{filename}"
exit 1
end
# Create an Amazon Polly client using
# credentials from the shared credentials file ~/.aws/credentials
# and the configuration (region) from the shared configuration file ~/.aws/config
polly = Aws::Polly::Client.new
resp = polly.synthesize_speech({
output_format: 'mp3',
text: contents,
voice_id: 'Joanna'
})
# Save output
# Get just the file name
# abc/xyz.txt -> xyx.txt
name = File.basename(filename)
# Split up name so we get just the xyz part
parts = name.split('.')
first_part = parts[0]
mp3_file = "#{first_part}.mp3"
IO.copy_stream(resp.audio_stream, mp3_file)
puts "Wrote MP3 content to: #{mp3_file}"
rescue StandardError => e
puts 'Got error:'
puts 'Error message:'
puts e.message
end
```
+ API에 대한 세부 정보는 *AWS SDK for Ruby API 참조*의 [SynthesizeSpeech](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech)를 참조하세요.
------
#### [ Rust ]
**SDK for Rust**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/polly#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
async fn synthesize(client: &Client, filename: &str) -> Result<(), Error> {
let content = fs::read_to_string(filename);
let resp = client
.synthesize_speech()
.output_format(OutputFormat::Mp3)
.text(content.unwrap())
.voice_id(VoiceId::Joanna)
.send()
.await?;
// Get MP3 data from response and save it
let mut blob = resp
.audio_stream
.collect()
.await
.expect("failed to read data");
let parts: Vec<&str> = filename.split('.').collect();
let out_file = format!("{}{}", String::from(parts[0]), ".mp3");
let mut file = tokio::fs::File::create(out_file)
.await
.expect("failed to create file");
file.write_all_buf(&mut blob)
.await
.expect("failed to write to file");
Ok(())
}
```
+ API 세부 정보는 *AWS SDK for Rust API 참조*의 [SynthesizeSpeech](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.synthesize_speech)를 참조하세요.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP API**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/ply#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
TRY.
" Only pass optional language code if it has a value
IF iv_lang_code IS NOT INITIAL.
oo_result = lo_ply->synthesizespeech(
iv_engine = iv_engine
iv_outputformat = iv_output_fmt
iv_text = iv_text
iv_voiceid = iv_voice_id
iv_languagecode = iv_lang_code ).
ELSE.
oo_result = lo_ply->synthesizespeech(
iv_engine = iv_engine
iv_outputformat = iv_output_fmt
iv_text = iv_text
iv_voiceid = iv_voice_id ).
ENDIF.
MESSAGE 'Speech synthesized successfully.' TYPE 'I'.
CATCH /aws1/cx_plyinvalidssmlex.
MESSAGE 'Invalid SSML.' TYPE 'E'.
CATCH /aws1/cx_plylexiconnotfoundex.
MESSAGE 'Lexicon not found.' TYPE 'E'.
CATCH /aws1/cx_plyservicefailureex.
MESSAGE 'Service failure occurred.' TYPE 'E'.
CATCH /aws1/cx_plytextlengthexcdex.
MESSAGE 'Text length exceeded maximum.' TYPE 'E'.
ENDTRY.
```
+ API 세부 정보는 SDK for SAP ABAP API 참조의 [SynthesizeSpeech](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)를 참조하세요. *AWS *
------
# AWS SDKs를 사용한 Amazon Polly 시나리오
다음 코드 예제에서는 Amazon Polly AWS SDKs에서 일반적인 시나리오를 구현하는 방법을 보여줍니다. 이러한 시나리오에서는 Amazon Polly 내에서 또는 다른 AWS 서비스와 결합된 상태에서 여러 함수를 직접적으로 호출하여 특정 작업을 수행하는 방법을 보여줍니다. 각 시나리오에는 전체 소스 코드에 대한 링크가 포함되어 있습니다. 여기에서 코드를 설정 및 실행하는 방법에 대한 지침을 찾을 수 있습니다.
시나리오는 컨텍스트에 맞는 서비스 작업을 이해하는 데 도움이 되도록 중급 수준의 경험을 대상으로 합니다.
**Topics**
+ [텍스트를 스피치로, 다시 스피치에서 텍스트로 변환](polly_example_cross_Telephone_section.md)
+ [립싱크 애플리케이션 생성](polly_example_polly_LipSync_section.md)
+ [고객 피드백 분석을 위한 애플리케이션 생성](polly_example_cross_FSA_section.md)
# AWS SDK를 사용하여 텍스트를 음성으로 변환하고 다시 텍스트로 변환
다음 코드 예시는 다음과 같은 작업을 수행하는 방법을 보여줍니다.
+ Amazon Polly를 사용하여 일반 텍스트(UTF-8) 입력 파일을 오디오 파일에 합성합니다.
+ Amazon S3 버킷에 오디오 파일을 업로드합니다.
+ Amazon Transcribe를 사용하여 오디오 파일을 텍스트로 변환합니다.
+ 텍스트를 표시합니다.
------
#### [ Rust ]
**SDK for Rust**
Amazon Polly를 사용하여 일반 텍스트(UTF-8) 입력 파일을 오디오 파일에 합성하고, 오디오 파일을 Amazon S3 버킷에 업로드하고, Amazon Transcribe를 사용하여 해당 오디오 파일을 텍스트로 변환하고, 텍스트를 표시합니다.
전체 소스 코드와 설정 및 실행 방법에 대한 지침은 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/rustv1/cross_service#code-examples)에서 전체 예시를 참조하세요.
**이 예제에서 사용되는 서비스**
+ Amazon Polly
+ Amazon S3
+ Amazon Transcribe
------
# AWS SDK를 사용하여 Amazon Polly로 립싱크 애플리케이션 생성
다음 코드 예제에서는 Amazon Polly를 사용하여 립싱크 애플리케이션을 생성하는 방법을 보여줍니다.
------
#### [ Python ]
**SDK for Python (Boto3)**
Amazon Polly와 Tkinter를 사용하여 Amazon Polly에서 합성된 스피치와 함께 움직이는 얼굴 말을 표시하는 립싱크 애플리케이션을 만드는 방법을 보여 줍니다. 립싱크는 Amazon Polly에 합성된 스피치와 일치하는 visemes 목록을 요청하여 수행됩니다.
+ Amazon Polly에서 음성 메타데이터를 가져와 Tkinter 애플리케이션에 표시합니다.
+ Amazon Polly에서 합성된 스피치 오디오와 그에 맞는 viseme 스피치 마크를 가져올 수 있습니다.
+ 움직이는 얼굴에서 동기화된 입 움직임으로 오디오를 재생합니다.
+ 긴 텍스트에 대한 비동기 합성 작업을 제출하고 Amazon Simple Storage Service(Amazon S3) 버킷에서 출력을 검색합니다.
전체 소스 코드와 설정 및 실행 방법에 대한 지침은 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples)에서 전체 예제를 참조하세요.
**이 예제에서 사용되는 서비스**
+ Amazon Polly
------
# 고객 피드백을 분석하고 오디오를 합성하는 애플리케이션 생성
다음 코드 예제에서는 고객 의견 카드를 분석하고, 원어에서 번역하고, 감정을 파악하고, 번역된 텍스트에서 오디오 파일을 생성하는 애플리케이션을 생성하는 방법을 보여줍니다.
------
#### [ .NET ]
**SDK for .NET**
이 예제 애플리케이션은 고객 피드백 카드를 분석하고 저장합니다. 특히 뉴욕시에 있는 가상 호텔의 필요를 충족합니다. 호텔은 다양한 언어의 고객들로부터 물리적인 의견 카드의 형태로 피드백을 받습니다. 피드백은 웹 클라이언트를 통해 앱에 업로드됩니다. 의견 카드의 이미지가 업로드된 후 다음 단계가 수행됩니다.
+ Amazon Textract를 사용하여 이미지에서 텍스트가 추출됩니다.
+ Amazon Comprehend가 추출된 텍스트와 해당 언어의 감정을 파악합니다.
+ 추출된 텍스트는 Amazon Translate를 사용하여 영어로 번역됩니다.
+ Amazon Polly가 추출된 텍스트에서 오디오 파일을 합성합니다.
전체 앱은 AWS CDK를 사용하여 배포할 수 있습니다. 소스 코드와 배포 지침은 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/cross-service/FeedbackSentimentAnalyzer)의 프로젝트를 참조하세요.
**이 예제에서 사용되는 서비스**
+ Amazon Comprehend
+ Lambda
+ Amazon Polly
+ Amazon Textract
+ Amazon Translate
------
#### [ Java ]
**SDK for Java 2.x**
이 예제 애플리케이션은 고객 피드백 카드를 분석하고 저장합니다. 특히 뉴욕시에 있는 가상 호텔의 필요를 충족합니다. 호텔은 다양한 언어의 고객들로부터 물리적인 의견 카드의 형태로 피드백을 받습니다. 피드백은 웹 클라이언트를 통해 앱에 업로드됩니다. 의견 카드의 이미지가 업로드된 후 다음 단계가 수행됩니다.
+ Amazon Textract를 사용하여 이미지에서 텍스트가 추출됩니다.
+ Amazon Comprehend가 추출된 텍스트와 해당 언어의 감정을 파악합니다.
+ 추출된 텍스트는 Amazon Translate를 사용하여 영어로 번역됩니다.
+ Amazon Polly가 추출된 텍스트에서 오디오 파일을 합성합니다.
전체 앱은 AWS CDK를 사용하여 배포할 수 있습니다. 소스 코드와 배포 지침은 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/usecases/creating_fsa_app)의 프로젝트를 참조하세요.
**이 예제에서 사용되는 서비스**
+ Amazon Comprehend
+ Lambda
+ Amazon Polly
+ Amazon Textract
+ Amazon Translate
------
#### [ JavaScript ]
**SDK for JavaScript (v3)**
이 예제 애플리케이션은 고객 피드백 카드를 분석하고 저장합니다. 특히 뉴욕시에 있는 가상 호텔의 필요를 충족합니다. 호텔은 다양한 언어의 고객들로부터 물리적인 의견 카드의 형태로 피드백을 받습니다. 피드백은 웹 클라이언트를 통해 앱에 업로드됩니다. 의견 카드의 이미지가 업로드된 후 다음 단계가 수행됩니다.
+ Amazon Textract를 사용하여 이미지에서 텍스트가 추출됩니다.
+ Amazon Comprehend가 추출된 텍스트와 해당 언어의 감정을 파악합니다.
+ 추출된 텍스트는 Amazon Translate를 사용하여 영어로 번역됩니다.
+ Amazon Polly가 추출된 텍스트에서 오디오 파일을 합성합니다.
전체 앱은 AWS CDK를 사용하여 배포할 수 있습니다. 소스 코드와 배포 지침은 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cross-services/feedback-sentiment-analyzer)의 프로젝트를 참조하세요. 다음 발췌문은 Lambda 함수 내에서 AWS SDK for JavaScript 가 사용되는 방법을 보여줍니다.
```
import {
ComprehendClient,
DetectDominantLanguageCommand,
DetectSentimentCommand,
} from "@aws-sdk/client-comprehend";
/**
* Determine the language and sentiment of the extracted text.
*
* @param {{ source_text: string}} extractTextOutput
*/
export const handler = async (extractTextOutput) => {
const comprehendClient = new ComprehendClient({});
const detectDominantLanguageCommand = new DetectDominantLanguageCommand({
Text: extractTextOutput.source_text,
});
// The source language is required for sentiment analysis and
// translation in the next step.
const { Languages } = await comprehendClient.send(
detectDominantLanguageCommand,
);
const languageCode = Languages[0].LanguageCode;
const detectSentimentCommand = new DetectSentimentCommand({
Text: extractTextOutput.source_text,
LanguageCode: languageCode,
});
const { Sentiment } = await comprehendClient.send(detectSentimentCommand);
return {
sentiment: Sentiment,
language_code: languageCode,
};
};
```
```
import {
DetectDocumentTextCommand,
TextractClient,
} from "@aws-sdk/client-textract";
/**
* Fetch the S3 object from the event and analyze it using Amazon Textract.
*
* @param {import("@types/aws-lambda").EventBridgeEvent<"Object Created">} eventBridgeS3Event
*/
export const handler = async (eventBridgeS3Event) => {
const textractClient = new TextractClient();
const detectDocumentTextCommand = new DetectDocumentTextCommand({
Document: {
S3Object: {
Bucket: eventBridgeS3Event.bucket,
Name: eventBridgeS3Event.object,
},
},
});
// Textract returns a list of blocks. A block can be a line, a page, word, etc.
// Each block also contains geometry of the detected text.
// For more information on the Block type, see https://docs.aws.amazon.com/textract/latest/dg/API_Block.html.
const { Blocks } = await textractClient.send(detectDocumentTextCommand);
// For the purpose of this example, we are only interested in words.
const extractedWords = Blocks.filter((b) => b.BlockType === "WORD").map(
(b) => b.Text,
);
return extractedWords.join(" ");
};
```
```
import { PollyClient, SynthesizeSpeechCommand } from "@aws-sdk/client-polly";
import { S3Client } from "@aws-sdk/client-s3";
import { Upload } from "@aws-sdk/lib-storage";
/**
* Synthesize an audio file from text.
*
* @param {{ bucket: string, translated_text: string, object: string}} sourceDestinationConfig
*/
export const handler = async (sourceDestinationConfig) => {
const pollyClient = new PollyClient({});
const synthesizeSpeechCommand = new SynthesizeSpeechCommand({
Engine: "neural",
Text: sourceDestinationConfig.translated_text,
VoiceId: "Ruth",
OutputFormat: "mp3",
});
const { AudioStream } = await pollyClient.send(synthesizeSpeechCommand);
const audioKey = `${sourceDestinationConfig.object}.mp3`;
// Store the audio file in S3.
const s3Client = new S3Client();
const upload = new Upload({
client: s3Client,
params: {
Bucket: sourceDestinationConfig.bucket,
Key: audioKey,
Body: AudioStream,
ContentType: "audio/mp3",
},
});
await upload.done();
return audioKey;
};
```
```
import {
TranslateClient,
TranslateTextCommand,
} from "@aws-sdk/client-translate";
/**
* Translate the extracted text to English.
*
* @param {{ extracted_text: string, source_language_code: string}} textAndSourceLanguage
*/
export const handler = async (textAndSourceLanguage) => {
const translateClient = new TranslateClient({});
const translateCommand = new TranslateTextCommand({
SourceLanguageCode: textAndSourceLanguage.source_language_code,
TargetLanguageCode: "en",
Text: textAndSourceLanguage.extracted_text,
});
const { TranslatedText } = await translateClient.send(translateCommand);
return { translated_text: TranslatedText };
};
```
**이 예제에서 사용되는 서비스**
+ Amazon Comprehend
+ Lambda
+ Amazon Polly
+ Amazon Textract
+ Amazon Translate
------
#### [ Ruby ]
**SDK for Ruby**
이 예제 애플리케이션은 고객 피드백 카드를 분석하고 저장합니다. 특히 뉴욕시에 있는 가상 호텔의 필요를 충족합니다. 호텔은 다양한 언어의 고객들로부터 물리적인 의견 카드의 형태로 피드백을 받습니다. 피드백은 웹 클라이언트를 통해 앱에 업로드됩니다. 의견 카드의 이미지가 업로드된 후 다음 단계가 수행됩니다.
+ Amazon Textract를 사용하여 이미지에서 텍스트가 추출됩니다.
+ Amazon Comprehend가 추출된 텍스트와 해당 언어의 감정을 파악합니다.
+ 추출된 텍스트는 Amazon Translate를 사용하여 영어로 번역됩니다.
+ Amazon Polly가 추출된 텍스트에서 오디오 파일을 합성합니다.
전체 앱은 AWS CDK를 사용하여 배포할 수 있습니다. 소스 코드와 배포 지침은 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/cross_service_examples/feedback_sentiment_analyzer)의 프로젝트를 참조하세요.
**이 예제에서 사용되는 서비스**
+ Amazon Comprehend
+ Lambda
+ Amazon Polly
+ Amazon Textract
+ Amazon Translate
------