D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation `SynthesizeSpeech` avec un AWS SDK
Les exemples de code suivants illustrent comment utiliser `SynthesizeSpeech`.
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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.");
}
}
```
Synthétisez la parole à partir du texte à l'aide de marques vocales avec Amazon Polly à l'aide d' 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}");
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [SynthesizeSpeech](https://docs.aws.amazon.com/goto/DotNetSDKV3/polly-2016-06-10/SynthesizeSpeech)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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;
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [SynthesizeSpeech](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/SynthesizeSpeech)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Python ]
**Kit SDK for Python (Boto3)**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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
```
+ Pour plus de détails sur l'API, consultez [SynthesizeSpeech](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/SynthesizeSpeech)le *AWS manuel de référence de l'API SDK for Python (Boto3*).
------
#### [ Ruby ]
**Kit SDK pour Ruby**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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
```
+ Pour plus de détails sur l'API, reportez-vous [SynthesizeSpeech](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/SynthesizeSpeech)à la section *Référence des AWS SDK pour Ruby API*.
------
#### [ Rust ]
**SDK pour Rust**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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(())
}
```
+ Pour plus de détails sur l'API, voir [SynthesizeSpeech](https://docs.rs/aws-sdk-polly/latest/aws_sdk_polly/client/struct.Client.html#method.synthesize_speech)la section de *référence de l'API AWS SDK for Rust*.
------
#### [ SAP ABAP ]
**Kit SDK pour SAP ABAP**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code 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.
```
+ Pour plus de détails sur l'API, reportez-vous [SynthesizeSpeech](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)à la section de référence du *AWS SDK pour l'API SAP ABAP*.
------