Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de código para Amazon Polly usando AWS SDKs
Los siguientes ejemplos de código muestran cómo utilizar Amazon Polly con un kit de desarrollo de AWS software (SDK).
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
Los *escenarios* son ejemplos de código que muestran cómo llevar a cabo una tarea específica a través de llamadas a varias funciones dentro del servicio o combinado con otros Servicios de AWS.
**Más recursos**
+ **[Guía para desarrolladores de Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/what-is.html)**: más información sobre Amazon Polly.
+ **[Referencia de la API de Amazon Polly](https://docs.aws.amazon.com/polly/latest/dg/API_Reference.html)**: información sobre todas las acciones disponibles de Amazon Polly.
+ **[AWS Centro para desarrolladores](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23polly)**: ejemplos de código que puede filtrar por categoría o por búsqueda de texto completo.
+ **[AWS Ejemplos de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)**: GitHub repositorio con código completo en los idiomas preferidos. Incluye instrucciones para configurar y ejecutar el código.
**Contents**
+ [Conceptos básicos](polly_code_examples_basics.md)
+ [Acciones](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)
+ [Escenarios](polly_code_examples_scenarios.md)
+ [Convierta texto en voz y de nuevo a texto](polly_example_cross_Telephone_section.md)
+ [Crear una aplicación de sincronización labial](polly_example_polly_LipSync_section.md)
+ [Creación de una aplicación para analizar los comentarios de los clientes](polly_example_cross_FSA_section.md)
# Ejemplos básicos de uso de Amazon Polly AWS SDKs
Los siguientes ejemplos de código muestran cómo utilizar los conceptos básicos de Amazon Polly con. AWS SDKs
**Contents**
+ [Acciones](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)
# Acciones para usar Amazon Polly AWS SDKs
Los siguientes ejemplos de código muestran cómo realizar acciones individuales de Amazon Polly con. AWS SDKs Cada ejemplo incluye un enlace a GitHub, donde puede encontrar instrucciones para configurar y ejecutar el código.
Estos fragmentos llaman a la API de Amazon Polly y son fragmentos de código de programas más grandes que se deben ejecutar en contexto. Puede ver las acciones en contexto en [Escenarios para el uso de Amazon Polly AWS SDKs](polly_code_examples_scenarios.md).
Los siguientes ejemplos incluyen solo las acciones que se utilizan con mayor frecuencia. Para ver una lista completa, consulte la [Referencia de la API de Amazon Polly](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)
# Úselo `DeleteLexicon` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `DeleteLexicon`.
------
#### [ .NET ]
**SDK para .NET**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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;
}
}
```
+ Para obtener más información sobre la API, consulta [DeleteLexicon](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/DeleteLexicon)la *Referencia AWS SDK para .NET de la API*.
------
#### [ CLI ]
**AWS CLI**
**Eliminación de un lexicón**
En el siguiente ejemplo de `delete-lexicon` se elimina el lexicón especificado.
```
aws polly delete-lexicon \
--name w3c
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Uso de la DeleteLexicon operación](https://docs.aws.amazon.com/polly/latest/dg/gs-delete-lexicon.html) en la Guía para *desarrolladores de Amazon Polly*.
+ Para obtener más información sobre la API, consulte [DeleteLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/delete-lexicon.html)la *Referencia de AWS CLI comandos*.
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [DeleteLexicon](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Úselo `DescribeVoices` con un SDK AWS
Los siguientes ejemplos de código muestran cómo utilizar `DescribeVoices`.
------
#### [ .NET ]
**SDK para .NET**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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}");
}
}
```
+ Para obtener más información sobre la API, consulta [DescribeVoices](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/DescribeVoices)la *Referencia AWS SDK para .NET de la API*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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);
}
}
}
```
+ Para obtener más información sobre la API, consulta [DescribeVoices](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [DescribeVoices](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ Ruby ]
**SDK para Ruby**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [DescribeVoices](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices)la *Referencia AWS SDK para Ruby de la API*.
------
#### [ Rust ]
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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(())
}
```
+ Para obtener más información sobre la API, consulta [DescribeVoices](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.describe_voices)la *referencia sobre la API de AWS SDK para Rust*.
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [DescribeVoices](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Úselo `GetLexicon` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `GetLexicon`.
------
#### [ .NET ]
**SDK para .NET**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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);
}
}
}
```
+ Para obtener más información sobre la API, consulta [GetLexicon](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/GetLexicon)la *Referencia AWS SDK para .NET de la API*.
------
#### [ CLI ]
**AWS CLI**
**Recuperación del contenido de un léxico**
En el siguiente ejemplo de `get-lexicon` se recupera el contenido del lexicón de pronunciación especificado.
```
aws polly get-lexicon \
--name w3c
```
Salida:
```
{
"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
}
}
```
Para obtener más información, consulte [Uso de la GetLexicon operación](https://docs.aws.amazon.com/polly/latest/dg/gs-get-lexicon.html) en la Guía para *desarrolladores de Amazon Polly*.
+ Para obtener más información sobre la API, consulte [GetLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-lexicon.html)la *Referencia de AWS CLI comandos*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [GetLexicon](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetLexicon)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [GetLexicon](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Úselo `GetSpeechSynthesisTask` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `GetSpeechSynthesisTask`.
------
#### [ CLI ]
**AWS CLI**
**Obtención de información sobre una tarea de síntesis de voz**
En el siguiente ejemplo de `get-speech-synthesis-task` se recupera información sobre la tarea de síntesis de voz especificada.
```
aws polly get-speech-synthesis-task \
--task-id 70b61c0f-57ce-4715-a247-cae8729dcce9
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Creación de archivos de audio largos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) en la *Guía para desarrolladores de Amazon Polly*.
+ Para obtener más información sobre la API, consulte [GetSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-speech-synthesis-task.html)la *Referencia de AWS CLI comandos*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [GetSpeechSynthesisTask](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/GetSpeechSynthesisTask)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [GetSpeechSynthesisTask](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Úselo `ListLexicons` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `ListLexicons`.
------
#### [ .NET ]
**SDK para .NET**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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}");
}
}
}
```
+ Para obtener más información sobre la API, consulta [ListLexicons](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/ListLexicons)la *Referencia AWS SDK para .NET de la API*.
------
#### [ CLI ]
**AWS CLI**
**Creación de una lista de léxicos**
En el siguiente ejemplo de `list-lexicons` se enumeran sus léxicos de pronunciación.
```
aws polly list-lexicons
```
Salida:
```
{
"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
}
}
]
}
```
Para obtener más información, consulte [Uso de la ListLexicons operación](https://docs.aws.amazon.com/polly/latest/dg/gs-list-lexicons.html) en la Guía para *desarrolladores de Amazon Polly*.
+ Para obtener más información sobre la API, consulte [ListLexicons](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-lexicons.html)la *Referencia de AWS CLI comandos*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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);
}
}
}
```
+ Para obtener más información sobre la API, consulta [ListLexicons](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/ListLexicons)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [ListLexicons](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/ListLexicons)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ Ruby ]
**SDK para Ruby**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [ListLexicons](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/ListLexicons)la *Referencia AWS SDK para Ruby de la API*.
------
#### [ Rust ]
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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(())
}
```
+ Para obtener más información sobre la API, consulta [ListLexicons](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.list_lexicons)la *referencia sobre la API de AWS SDK para Rust*.
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [ListLexicons](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Úselo `ListSpeechSynthesisTasks` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `ListSpeechSynthesisTasks`.
------
#### [ CLI ]
**AWS CLI**
**Para enumerar sus tareas de síntesis de voz**
En el siguiente ejemplo de `list-speech-synthesis-tasks`, se enumeran las tareas de síntesis de voz.
```
aws polly list-speech-synthesis-tasks
```
Salida:
```
{
"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"
}
]
}
```
Para obtener más información, consulte [Creación de archivos de audio largos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) en la *Guía para desarrolladores de Amazon Polly*.
+ Para obtener más información sobre la API, consulte [ListSpeechSynthesisTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-speech-synthesis-tasks.html)la *Referencia de AWS CLI comandos*.
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [ListSpeechSynthesisTasks](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Úselo `PutLexicon` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `PutLexicon`.
------
#### [ .NET ]
**SDK para .NET**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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);
}
}
}
```
+ Para obtener más información sobre la API, consulta [PutLexicon](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/PutLexicon)la *Referencia AWS SDK para .NET de la API*.
------
#### [ CLI ]
**AWS CLI**
**Almacenamiento de un léxico**
En el siguiente ejemplo de `put-lexicon` se almacena el léxico de pronunciación especificado. El archivo `example.pls` especifica un léxico compatible con PLS de W3C.
```
aws polly put-lexicon \
--name w3c \
--content file://example.pls
```
Contenido de `example.pls`
```
{
W3C
World Wide Web Consortium
}
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Uso de la PutLexicon operación](https://docs.aws.amazon.com/polly/latest/dg/gs-put-lexicon.html) en la Guía para *desarrolladores de Amazon Polly*.
+ Para obtener más información sobre la API, consulte [PutLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/put-lexicon.html)la *Referencia de AWS CLI comandos*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [PutLexicon](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/PutLexicon)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ Rust ]
**SDK para Rust**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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(())
}
```
+ Para obtener más información sobre la API, consulta [PutLexicon](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.put_lexicon)la *referencia sobre la API de AWS SDK para Rust*.
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [PutLexicon](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Úselo `StartSpeechSynthesisTask` con un AWS SDK o CLI
Los siguientes ejemplos de código muestran cómo utilizar `StartSpeechSynthesisTask`.
------
#### [ CLI ]
**AWS CLI**
**Sintetización de texto**
El siguiente `start-speech-synthesis-task` ejemplo sintetiza el texto `text_file.txt` y almacena el MP3 archivo resultante en el depósito especificado.
```
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
```
Salida:
```
{
"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"
}
}
```
Para obtener más información, consulte [Creación de archivos de audio largos](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) en la *Guía para desarrolladores de Amazon Polly*.
+ Para obtener más información sobre la API, consulte [StartSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/start-speech-synthesis-task.html)la *Referencia de AWS CLI comandos*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [StartSpeechSynthesisTask](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/StartSpeechSynthesisTask)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [StartSpeechSynthesisTask](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Úselo `SynthesizeSpeech` con un SDK AWS
Los siguientes ejemplos de código muestran cómo utilizar `SynthesizeSpeech`.
------
#### [ .NET ]
**SDK para .NET**
Hay más en marcha GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.");
}
}
```
Sintetice voz a partir de texto mediante marcas de voz con Amazon Polly mediante AWS un SDK.
```
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}");
}
}
}
```
+ Para obtener más información sobre la API, consulte la referencia de [SynthesizeSpeech](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/SynthesizeSpeech)la *AWS SDK para .NET API*.
------
#### [ Java ]
**SDK para Java 2.x**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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;
}
}
```
+ Para obtener más información sobre la API, consulta [SynthesizeSpeech](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech)la *Referencia AWS SDK for Java 2.x de la API*.
------
#### [ Python ]
**SDK para Python (Boto3)**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [SynthesizeSpeech](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech)la *AWS Referencia de API de SDK for Python (Boto3*).
------
#### [ Ruby ]
**SDK para Ruby**
Hay más información al respecto. GitHub Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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
```
+ Para obtener más información sobre la API, consulta [SynthesizeSpeech](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech)la *Referencia AWS SDK para Ruby de la API*.
------
#### [ Rust ]
**SDK para Rust**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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(())
}
```
+ Para obtener más información sobre la API, consulta [SynthesizeSpeech](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.synthesize_speech)la *referencia sobre la API de AWS SDK para Rust*.
------
#### [ SAP ABAP ]
**SDK para SAP ABAP**
Hay más información al respecto GitHub. Busque el ejemplo completo y aprenda a configurar y ejecutar en el [Repositorio de ejemplos de código de 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.
```
+ Para obtener más información sobre la API, consulte [SynthesizeSpeech](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)la *referencia sobre la API ABAP del AWS SDK para SAP*.
------
# Escenarios para el uso de Amazon Polly AWS SDKs
Los siguientes ejemplos de código muestran cómo implementar escenarios comunes en Amazon Polly con. AWS SDKs Estos escenarios muestran cómo realizar tareas específicas con llamadas a varias funciones dentro de Amazon Polly o en combinación con otros Servicios de AWS. En cada escenario se incluye un enlace al código fuente completo, con instrucciones de configuración y ejecución del código.
Los escenarios requieren un nivel intermedio de experiencia para entender las acciones de servicio en su contexto.
**Topics**
+ [Convierta texto en voz y de nuevo a texto](polly_example_cross_Telephone_section.md)
+ [Crear una aplicación de sincronización labial](polly_example_polly_LipSync_section.md)
+ [Creación de una aplicación para analizar los comentarios de los clientes](polly_example_cross_FSA_section.md)
# Convierta texto en voz y vuelva a convertirlo en texto mediante un SDK AWS
En el siguiente ejemplo de código, se muestra cómo:
+ Utilice Amazon Polly para sintetizar un archivo de entrada de texto sin formato (UTF-8) en un archivo de audio.
+ Cargue el archivo de audio en un bucket de Amazon S3.
+ Utilice Amazon Transcribe para convertir el archivo de audio en texto.
+ Muestre el texto.
------
#### [ Rust ]
**SDK para Rust**
Utilice Amazon Polly para sintetizar un archivo de entrada de texto sin formato (UTF-8) en un archivo de audio, cargue el archivo de audio en un bucket de Amazon S3, utilice Amazon Transcribe para convertir ese archivo de audio en texto y muestre el texto.
Para obtener el código fuente completo y las instrucciones sobre cómo configurarlo y ejecutarlo, consulte el ejemplo completo en [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/rustv1/cross_service#code-examples).
**Servicios utilizados en este ejemplo**
+ Amazon Polly
+ Amazon S3
+ Amazon Transcribe
------
# Cree una aplicación de sincronización de labios con Amazon Polly mediante un SDK AWS
El siguiente ejemplo de código muestra cómo crear una aplicación de sincronización labial con Amazon Polly.
------
#### [ Python ]
**SDK para Python (Boto3)**
Muestra cómo usar Amazon Polly y Tkinter para crear una aplicación de sincronización labial que muestre un rostro animado hablando junto con el discurso sintetizado por Amazon Polly. La sincronización labial se realiza solicitando una lista de visemas de Amazon Polly que coincidan con la voz sintetizada.
+ Obtenga metadatos de voz de Amazon Polly y muéstrelos en una aplicación de Tkinter.
+ Obtenga audio de voz sintetizado y marcas de voz de visema coincidentes de Amazon Polly.
+ Reproduzca el audio con los movimientos de la boca sincronizados en una cara animada.
+ Envíe tareas de síntesis asincrónicas para textos de gran tamaño y recupere los datos de salida desde un bucket de Amazon Simple Storage Service (Amazon S3).
Para obtener el código fuente completo y las instrucciones sobre cómo configurarlo y ejecutarlo, consulte el ejemplo completo en [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/polly#code-examples).
**Servicios utilizados en este ejemplo**
+ Amazon Polly
------
# Creación de una aplicación que analice los comentarios de los clientes y sintetice el audio
En los siguientes ejemplos de código, se muestra cómo crear una aplicación que analice las tarjetas de comentarios de los clientes, las traduzca del idioma original, determine sus opiniones y genere un archivo de audio a partir del texto traducido.
------
#### [ .NET ]
**SDK para .NET**
Esta aplicación de ejemplo analiza y almacena las tarjetas de comentarios de los clientes. Concretamente, satisface la necesidad de un hotel ficticio en la ciudad de Nueva York. El hotel recibe comentarios de los huéspedes en varios idiomas en forma de tarjetas de comentarios físicas. Esos comentarios se cargan en la aplicación a través de un cliente web. Una vez cargada la imagen de una tarjeta de comentarios, se llevan a cabo los siguientes pasos:
+ El texto se extrae de la imagen mediante Amazon Textract.
+ Amazon Comprehend determina la opinión del texto extraído y su idioma.
+ El texto extraído se traduce al inglés mediante Amazon Translate.
+ Amazon Polly sintetiza un archivo de audio a partir del texto extraído.
La aplicación completa se puede implementar con AWS CDK. Para obtener el código fuente y las instrucciones de implementación, consulte el proyecto en [ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/cross-service/FeedbackSentimentAnalyzer).
**Servicios utilizados en este ejemplo**
+ Amazon Comprehend
+ Lambda
+ Amazon Polly
+ Amazon Textract
+ Amazon Translate
------
#### [ Java ]
**SDK para Java 2.x**
Esta aplicación de ejemplo analiza y almacena las tarjetas de comentarios de los clientes. Concretamente, satisface la necesidad de un hotel ficticio en la ciudad de Nueva York. El hotel recibe comentarios de los huéspedes en varios idiomas en forma de tarjetas de comentarios físicas. Esos comentarios se cargan en la aplicación a través de un cliente web. Una vez cargada la imagen de una tarjeta de comentarios, se llevan a cabo los siguientes pasos:
+ El texto se extrae de la imagen mediante Amazon Textract.
+ Amazon Comprehend determina la opinión del texto extraído y su idioma.
+ El texto extraído se traduce al inglés mediante Amazon Translate.
+ Amazon Polly sintetiza un archivo de audio a partir del texto extraído.
La aplicación completa se puede implementar con AWS CDK. Para obtener el código fuente y las instrucciones de implementación, consulte el proyecto en [ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/usecases/creating_fsa_app).
**Servicios utilizados en este ejemplo**
+ Amazon Comprehend
+ Lambda
+ Amazon Polly
+ Amazon Textract
+ Amazon Translate
------
#### [ JavaScript ]
**SDK para JavaScript (v3)**
Esta aplicación de ejemplo analiza y almacena las tarjetas de comentarios de los clientes. Concretamente, satisface la necesidad de un hotel ficticio en la ciudad de Nueva York. El hotel recibe comentarios de los huéspedes en varios idiomas en forma de tarjetas de comentarios físicas. Esos comentarios se cargan en la aplicación a través de un cliente web. Una vez cargada la imagen de una tarjeta de comentarios, se llevan a cabo los siguientes pasos:
+ El texto se extrae de la imagen mediante Amazon Textract.
+ Amazon Comprehend determina la opinión del texto extraído y su idioma.
+ El texto extraído se traduce al inglés mediante Amazon Translate.
+ Amazon Polly sintetiza un archivo de audio a partir del texto extraído.
La aplicación completa se puede implementar con AWS CDK. Para obtener el código fuente y las instrucciones de implementación, consulte el proyecto en [ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cross-services/feedback-sentiment-analyzer). Los siguientes extractos muestran cómo AWS SDK para JavaScript se usa dentro de las funciones Lambda.
```
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 };
};
```
**Servicios utilizados en este ejemplo**
+ Amazon Comprehend
+ Lambda
+ Amazon Polly
+ Amazon Textract
+ Amazon Translate
------
#### [ Ruby ]
**SDK para Ruby**
Esta aplicación de ejemplo analiza y almacena las tarjetas de comentarios de los clientes. Concretamente, satisface la necesidad de un hotel ficticio en la ciudad de Nueva York. El hotel recibe comentarios de los huéspedes en varios idiomas en forma de tarjetas de comentarios físicas. Esos comentarios se cargan en la aplicación a través de un cliente web. Una vez cargada la imagen de una tarjeta de comentarios, se llevan a cabo los siguientes pasos:
+ El texto se extrae de la imagen mediante Amazon Textract.
+ Amazon Comprehend determina la opinión del texto extraído y su idioma.
+ El texto extraído se traduce al inglés mediante Amazon Translate.
+ Amazon Polly sintetiza un archivo de audio a partir del texto extraído.
La aplicación completa se puede implementar con AWS CDK. Para obtener el código fuente y las instrucciones de implementación, consulte el proyecto en. [ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby/cross_service_examples/feedback_sentiment_analyzer)
**Servicios utilizados en este ejemplo**
+ Amazon Comprehend
+ Lambda
+ Amazon Polly
+ Amazon Textract
+ Amazon Translate
------