הקראת כתובות באמצעות SSML

במדריך הזה נדגים איך משתמשים ב-Speech Synthesis Markup Language (SSML) כדי להקריא קובץ טקסט של כתובות. אתם יכולים להשתמש בתגי SSML כדי להוסיף סימון למחרוזת טקסט ולהתאים אישית את האודיו הסינתטי מ-Cloud Text-to-Speech.

Plaintext רינדור של טקסט רגיל ב-SSML 
123 Street Ln

<speak>123 Street Ln</speak>

1 Number St

<speak>1 Number St</speak>

1 Piazza del Fibonacci

<speak>1 Piazza del Fibonacci</speak>

מטרה

שליחת בקשה לסינתזת דיבור ל-Cloud Text-to-Speech באמצעות SSML וספריות הלקוח של Cloud Text-to-Speech.

עלויות

מידע על עלויות זמין בדף התמחור של Cloud TTS.

לפני שמתחילים

הורדת דוגמאות קוד

כדי להוריד את דוגמאות הקוד, משכפלים את Google Cloud הדוגמאות של GitHub לשפת התכנות שבה רוצים להשתמש.

Java

במדריך הזה נעשה שימוש בקוד בספרייה texttospeech/cloud-client/src/main/java/com/example/texttospeech/ של מאגר הדוגמאות של Java ב-Google Cloud Platform.

כדי להוריד את הקוד של המדריך הזה ולעבור אליו, מריצים את הפקודות הבאות מהטרמינל.

git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
cd java-docs-samples/texttospeech/cloud-client/src/main/java/com/example/texttospeech/

Node.js

במדריך הזה נעשה שימוש בקוד בספרייה texttospeech של מאגר הדוגמאות של Google Cloud Platform Node.js.

כדי להוריד את הקוד של ההדרכה הזו ולעבור אליו, מריצים את הפקודות הבאות מהטרמינל.

git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
cd texttospeech/

Python

במדריך הזה נעשה שימוש בקוד בספרייה texttospeech/snippets של מאגר הדוגמאות של Python ב-Google Cloud Platform.

כדי להוריד את הקוד של המדריך הזה ולעבור אליו, מריצים את הפקודות הבאות מהטרמינל.

git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
cd samples/snippets

התקנת ספריית הלקוח

במדריך הזה נעשה שימוש בספריית הלקוח Text-to-Speech.

Java

המדריך הזה משתמש בתלות הבאה.

<!--  Using libraries-bom to manage versions.
See https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.32.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-texttospeech</artifactId>
  </dependency>
</dependencies>

Node.js

מריצים את הפקודה הבאה מהטרמינל.

npm install @google-cloud/text-to-speech

Python

מריצים את הפקודה הבאה מהטרמינל.

pip install --upgrade google-cloud-texttospeech

הגדרת פרטי הכניסה ל-Google Cloud Platform

מגדירים את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS כדי לספק את פרטי הכניסה לקוד האפליקציה. המשתנה הזה חל רק על סשן המעטפת הנוכחי. אם רוצים שהמשתנה יחול על סשנים נוספים של המעטפת, מגדירים את המשתנה בקובץ ההפעלה של המעטפת – למשל בקובץ ~/.bashrc או בקובץ ~/.profile.

Linux או macOS

export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

מחליפים את KEY_PATH בנתיב של קובץ ה-JSON שמכיל את פרטי הכניסה.

לדוגמה:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

Windows

ל-PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"

מחליפים את KEY_PATH בנתיב של קובץ ה-JSON שמכיל את פרטי הכניסה.

לדוגמה:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"

בשורת הפקודה:

set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH

מחליפים את KEY_PATH בנתיב של קובץ ה-JSON שמכיל את פרטי הכניסה.

ייבוא ספריות

במדריך הזה נעשה שימוש במערכת ובספריות הלקוח הבאות.

Java

מידע על התקנת ספריית הלקוח של Cloud TTS ושימוש בה מופיע במאמר ספריות הלקוח של Cloud TTS. מידע נוסף מופיע במאמרי העזרה של Cloud TTS Java API.

כדי לבצע אימות ב-Cloud TTS, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.