استخدام واجهة برمجة تطبيقات تحويل النص إلى كلام مع Node.js

1. نظرة عامة

تتيح Google Cloud Text-to-Speech API للمطوّرين تضمين كلام بشري اصطناعي يبدو طبيعيًا كصوت قابل للتشغيل في تطبيقاتهم. تحوّل واجهة برمجة التطبيقات Text-to-Speech API النص أو إدخال لغة ترميز تركيب الكلام (SSML) إلى بيانات صوتية، مثل MP3 أو LINEAR16 (الترميز المستخدَم في ملفات WAV).

في هذا الدرس التطبيقي حول الترميز، ستركز على استخدام Text-to-Speech API مع Node.js. ستتعرّف على كيفية إدراج الأصوات المتاحة وتركيب الصوت من النص.

ما ستتعلمه

• كيفية استخدام Cloud Shell
• كيفية تفعيل واجهة برمجة التطبيقات Text-to-Speech API
• كيفية المصادقة على طلبات البيانات من واجهة برمجة التطبيقات
• كيفية تثبيت مكتبة عملاء Google Cloud لنظام التشغيل Node.js
• كيفية إدراج الأصوات المتاحة
• كيفية إنشاء صوت من نص

المتطلبات

• مشروع على Google Cloud Platform
• متصفّح، مثل Chrome أو Firefox
• الإلمام باستخدام Node.js

استطلاع الرأي

كيف ستستخدم هذا البرنامج التعليمي؟

قراءة النص فقط قراءة النص وإكمال التمارين

كيف تقيّم تجربتك مع Node.js؟

مبتدئ متوسط متقن

ما هو تقييمك لتجربة استخدام خدمات Google Cloud Platform؟

مبتدئ متوسط متقدّم

2. الإعداد والمتطلبات

إعداد البيئة بالسرعة التي تناسبك

1. سجِّل الدخول إلى Cloud Console وأنشِئ مشروعًا جديدًا أو أعِد استخدام مشروع حالي. (إذا لم يكن لديك حساب على Gmail أو G Suite، عليك إنشاء حساب).

ملاحظة: يمكنك الوصول بسهولة إلى Cloud Console من خلال تذكُّر عنوان URL الخاص بها، وهو console.cloud.google.com.

تذكَّر رقم تعريف المشروع، وهو اسم فريد في جميع مشاريع Google Cloud (الاسم أعلاه مستخدَم حاليًا ولن يكون متاحًا لك، نأسف لذلك). سيتم الإشارة إليه لاحقًا في هذا الدرس التطبيقي حول الترميز باسم PROJECT_ID.

ملاحظة: إذا كنت تستخدم حساب Gmail، يمكنك ترك الموقع الجغرافي التلقائي مضبوطًا على بدون مؤسسة. إذا كنت تستخدم حساب G Suite، اختَر موقعًا جغرافيًا مناسبًا لمؤسستك.

2. بعد ذلك، عليك تفعيل الفوترة في Cloud Console من أجل استخدام موارد Google Cloud.

لن تكلفك تجربة هذا الدرس البرمجي الكثير من المال، إن وُجدت تكلفة على الإطلاق. احرص على اتّباع أي تعليمات في قسم "التنظيف" الذي ينصحك بكيفية إيقاف الموارد حتى لا يتم تحصيل رسوم منك بعد هذا البرنامج التعليمي. يمكن لمستخدمي Google Cloud الجدد الاستفادة من برنامج الفترة التجريبية المجانية بقيمة 300 دولار أمريكي.

بدء Cloud Shell

على الرغم من إمكانية تشغيل Google Cloud عن بُعد من الكمبيوتر المحمول، ستستخدم في هذا الدرس التطبيقي حول الترميز Google Cloud Shell، وهي بيئة سطر أوامر تعمل في السحابة الإلكترونية.

تفعيل Cloud Shell

1. من Cloud Console، انقر على تفعيل Cloud Shell .

إذا لم يسبق لك بدء Cloud Shell، ستظهر لك شاشة وسيطة (الجزء السفلي غير المرئي من الصفحة) توضّح ماهيته. في هذه الحالة، انقر على متابعة (ولن تظهر لك مرة أخرى). إليك الشكل الذي ستظهر به هذه الشاشة لمرة واحدة:

يستغرق توفير Cloud Shell والاتصال به بضع لحظات فقط.

يتم تحميل هذه الآلة الافتراضية مزوّدة بكل أدوات التطوير التي ستحتاج إليها. توفّر هذه الخدمة دليلًا منزليًا دائمًا بسعة 5 غيغابايت وتعمل في Google Cloud، ما يؤدي إلى تحسين أداء الشبكة والمصادقة بشكل كبير. يمكن إنجاز معظم العمل في هذا الدرس البرمجي، إن لم يكن كله، باستخدام متصفّح أو جهاز Chromebook فقط.

بعد الاتصال بـ Cloud Shell، من المفترض أن يظهر لك أنّه تم إثبات هويتك وأنّه تم ضبط المشروع على رقم تعريف مشروعك.

2. نفِّذ الأمر التالي في Cloud Shell للتأكّد من إثبات هويتك:

gcloud auth list

ناتج الأمر

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

ملاحظة: أداة سطر الأوامر gcloud هي أداة سطر أوامر موحّدة وفعّالة في Google Cloud. ويتم تثبيته مسبقًا في Cloud Shell. ستلاحظ إمكانية إكمال علامات التبويب. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على أداة سطر أوامر gcloud.

gcloud config list project

ناتج الأمر

[core]
project = <PROJECT_ID>

إذا لم يكن كذلك، يمكنك تعيينه من خلال هذا الأمر:

gcloud config set project <PROJECT_ID>

ناتج الأمر

Updated property [core/project].

3- تفعيل Text-to-Speech API

قبل أن تتمكّن من بدء استخدام Text-to-Speech API، عليك تفعيلها. يمكنك تفعيل واجهة برمجة التطبيقات باستخدام الأمر التالي في Cloud Shell:

gcloud services enable texttospeech.googleapis.com

ملاحظة: إذا ظهرت رسالة خطأ عند تنفيذ هذا الأمر، تأكَّد من أنّ رقم تعريف المشروع الحالي يتطابق مع رقم تعريف مشروعك في Codelab.

استخدِم الأمر التالي للعثور على رقم تعريف المشروع الحالي الذي يستخدمه Cloud Shell:

gcloud info | grep "project"

إذا كان رقم تعريف المشروع غير صحيح، استخدِم الأمر التالي لاستخدام رقم تعريف المشروع الصحيح:

gcloud config set project <PROJECT_ID>

استبدِل <PROJECT_ID> برقم تعريف المشروع الصحيح.

4. مصادقة طلبات البيانات من واجهة برمجة التطبيقات

لإرسال طلبات إلى Text-to-Speech API، عليك استخدام حساب خدمة. حساب الخدمة هو حساب خاص بمشروعك، وتستخدمه مكتبة Google Client Node.js لتقديم طلبات إلى Text-to-Speech API. وكما هو الحال مع أي حساب مستخدم آخر، يتم تمثيل حساب الخدمة بعنوان بريد إلكتروني. في هذا القسم، ستستخدم Cloud SDK لإنشاء حساب خدمة، ثم ستنشئ بيانات الاعتماد اللازمة للمصادقة بصفتك حساب الخدمة.

أولاً، اضبط متغيّر بيئة باستخدام GOOGLE_CLOUD_PROJECT الذي ستستخدمه في هذا الدرس التطبيقي حول الترميز:

export GOOGLE_CLOUD_PROJECT=$(gcloud config get-value core/project)

بعد ذلك، أنشِئ حساب خدمة جديدًا للوصول إلى Text-to-Speech API باستخدام:

gcloud iam service-accounts create my-text-to-speech-sa \
  --display-name "my text-to-speech codelab service account"

بعد ذلك، أنشِئ بيانات اعتماد سيستخدمها رمز Node.js لتسجيل الدخول بصفتك حساب الخدمة الجديد. أنشئ بيانات الاعتماد هذه واحفظها كملف JSON باسم "~/key.json" باستخدام الأمر التالي:

gcloud iam service-accounts keys create ~/key.json \
  --iam-account  my-text-to-speech-sa@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com

أخيرًا، اضبط متغيّر البيئة GOOGLE_APPLICATION_CREDENTIALS الذي تستخدمه مكتبة Text-to-Speech API Node.js، التي سيتم تناولها في الخطوة التالية، للعثور على بيانات الاعتماد. يجب ضبط متغيّر البيئة على المسار الكامل لملف JSON الخاص ببيانات الاعتماد الذي أنشأته، وذلك باستخدام:

export GOOGLE_APPLICATION_CREDENTIALS="/home/${USER}/key.json"

5- تثبيت مكتبة برامج واجهة Google Cloud Text-to-Speech API لنظام التشغيل Node.js

أولاً، أنشئ مشروعًا ستستخدمه لتشغيل هذا المختبر الخاص بواجهة برمجة التطبيقات Text-to-Speech API، ثم ابدأ حزمة Node.js جديدة في مجلد من اختيارك:

npm init

يطرح NPM عدة أسئلة حول إعدادات المشروع، مثل الاسم والإصدار. لكل سؤال، اضغط على ENTER لقبول القيم التلقائية. نقطة الدخول التلقائية هي ملف باسم index.js.

بعد ذلك، ثبِّت مكتبة Google Cloud Speech في المشروع:

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

للحصول على مزيد من التعليمات حول كيفية إعداد بيئة تطوير Node.js على Google Cloud، يُرجى الاطّلاع على دليل الإعداد.

أنت الآن على استعداد لاستخدام Text-to-Speech API.

6. List Available Voices

في هذا القسم، عليك أولاً إدراج جميع الأصوات المتاحة باللغة الإنجليزية لتركيب الصوت.

انتقِل إلى ملف index.js داخل المجلد واستبدِل الرمز بالرمز التالي:

'use strict';

/**
 * Lists available voices for the specified language.
 *
 * @param {string} languageCode - The language code.
 */
async function listVoices(languageCode) {
  const textToSpeech = require('@google-cloud/text-to-speech');

  const client = new textToSpeech.TextToSpeechClient();

  const [result] = await client.listVoices({languageCode});
  const voices = result.voices;

  voices.forEach((voice) => {
    console.log(`${voice.name} (${voice.ssmlGender}): ${voice.languageCodes}`);
  });
}

listVoices('en');

خصِّص دقيقة أو دقيقتين لدراسة الرمز. تشغيل التطبيق:

node . 

من المفترض أن يظهر لك الناتج التالي:

en-US-Standard-A (MALE): en-US
en-US-Standard-B (MALE): en-US
en-US-Standard-C (FEMALE): en-US
en-US-Standard-D (MALE): en-US
en-US-Standard-E (FEMALE): en-US
en-US-Standard-F (FEMALE): en-US
...

ملاحظة: إذا لم يعمل رمز Node.js هذا، تحقَّق من التعليمات التي اتّبعتها أثناء خطوة مصادقة طلبات واجهة برمجة التطبيقات.

استخدِم الأمر التالي للتحقّق من قيمة متغيّر البيئة GOOGLE_APPLICATION_CREDENTIALS:

echo GOOGLE_APPLICATION_CREDENTIALS

يجب أن تعرض القيمة "~/key.json".

إذا كان الأمر كذلك، تحقَّق بعد ذلك من إنشاء حساب خدمة وتحديد موقعه في "~/key.json" باستخدام:

cat "~/key.json"

من المفترض أن يظهر لك محتوى مشابه لما يلي:

{

"type": "service_account",

"project_id": "PROJECT_ID",

"private_key_id": "ff31939192529e07f42e4535fb20bb029def1276",

"Private_key":...

إذا لم يكن الأمر كذلك، أعِد زيارة خطوة مصادقة طلبات واجهة برمجة التطبيقات.

7. إنشاء صوت من نص

يمكنك استخدام Text-to-Speech API لتحويل سلسلة إلى بيانات صوتية. يمكنك ضبط إخراج تركيب الكلام بطرق متنوعة، بما في ذلك اختيار صوت فريد أو تعديل الإخراج من حيث النبرة ومستوى الصوت وسرعة الكلام ومعدّل أخذ العينات.

انتقِل إلى ملف index.js داخل المجلد وأضِف الرمز التالي:

/**
 * Sythesizes sample text into an .mp3 file.
 */
async function synthesize() {
  const textToSpeech = require('@google-cloud/text-to-speech');
  const fs = require('fs');
  const util = require('util');

  const client = new textToSpeech.TextToSpeechClient();

  const text = 'This is a demonstration of the Google Cloud Text-to-Speech API';

  const request = {
    input: {text: text},
    voice: {languageCode: 'en-US', ssmlGender: 'NEUTRAL'},
    audioConfig: {audioEncoding: 'MP3'},
  };

  const [response] = await client.synthesizeSpeech(request);
  // Write the binary audio content to a local file
  const writeFile = util.promisify(fs.writeFile);
  await writeFile('output.mp3', response.audioContent, 'binary');
  console.log('Audio content written to file: output.mp3');
}

synthesize();

خصِّص دقيقة أو دقيقتين لدراسة الرمز البرمجي ومعرفة كيفية استخدامه لإنشاء ملف صوتي من نص.

node .

من المفترض أن يظهر لك الناتج التالي:

Audio content written to file "output.mp3"

8. تهانينا!

لقد تعلّمت كيفية استخدام Text-to-Speech API باستخدام Node.js لإجراء أنواع مختلفة من عمليات تحويل الصوت إلى نص على ملفات صوتية.

تَنظيم

لتجنُّب تحمّل رسوم في حسابك على Google Cloud Platform مقابل الموارد المستخدَمة في هذا الدليل السريع، اتّبِع الخطوات التالية:

• انتقِل إلى وحدة تحكّم Cloud Platform.
• اختَر المشروع الذي تريد إيقافه، ثم انقر على "حذف" في أعلى الصفحة: يؤدي ذلك إلى تحديد موعد لحذف المشروع.

مزيد من المعلومات

• ‫Google Cloud Text-to-Speech API: https://cloud.google.com/text-to-speech/docs
• ‫Node.js على Google Cloud Platform: ‏ https://cloud.google.com/nodejs/
• برنامج Google Cloud Node.js: https://googlecloudplatform.github.io/google-cloud-node/

الترخيص

يخضع هذا العمل لترخيص Creative Commons Attribution 2.0 Generic License.