chrome.tts

বিবরণ

অপারেটিং সিস্টেম দ্বারা প্রদত্ত স্পিচ সংশ্লেষণ ক্ষমতা ব্যবহার করে, Chrome উইন্ডোজ (SAPI 5 ব্যবহার করে), Mac OS X এবং ChromeOS-এ এই ক্ষমতা প্রদান করে। সমস্ত প্ল্যাটফর্মে, ব্যবহারকারী এমন এক্সটেনশন ইনস্টল করতে পারেন যা নিজেদেরকে বিকল্প স্পিচ ইঞ্জিন হিসাবে নিবন্ধিত করে।

অনুমতিসমূহ

ধারণা এবং ব্যবহার

বক্তৃতা তৈরি করুন

আপনার এক্সটেনশন থেকে speak() কল করে কথা বলুন। উদাহরণস্বরূপ:

chrome.tts.speak('Hello, world.');

অবিলম্বে কথা বলা বন্ধ করতে, শুধু stop() কল করুন :

chrome.tts.stop();

আপনি এমন বিকল্প প্রদান করতে পারেন যা বক্তৃতার বিভিন্ন বৈশিষ্ট্য নিয়ন্ত্রণ করে, যেমন এর গতি, পিচ এবং আরও অনেক কিছু। উদাহরণস্বরূপ:

chrome.tts.speak('Hello, world.', {'rate': 2.0});

ভাষাটি নির্দিষ্ট করাও একটি ভালো ধারণা যাতে সেই ভাষা (এবং প্রযোজ্য ক্ষেত্রে আঞ্চলিক উপভাষা) সমর্থনকারী একটি সিন্থেসাইজার বেছে নেওয়া হয়।

chrome.tts.speak('Hello, world.', {'lang': 'en-US', 'rate': 2.0});

ডিফল্টরূপে, প্রতিটি কল to speak() যেকোনো চলমান বক্তৃতাকে বাধাগ্রস্ত করে এবং তাৎক্ষণিকভাবে কথা বলে। কোনও কল কোনও কিছুতে বাধা সৃষ্টি করছে কিনা তা নির্ধারণ করতে, আপনি isSpeaking() কল করতে পারেন। এছাড়াও, আপনি enqueue বিকল্পটি ব্যবহার করে এই উচ্চারণটি উচ্চারণের একটি সারিতে যুক্ত করতে পারেন যা বর্তমান উচ্চারণটি শেষ হওয়ার পরে বলা হবে।

chrome.tts.speak('Speak this first.');
chrome.tts.speak(
    'Speak this next, when the first sentence is done.', {'enqueue': true});

সকল অপশনের সম্পূর্ণ বিবরণ tts.speak() এর অধীনে পাওয়া যাবে। সকল স্পিচ ইঞ্জিন সকল অপশন সমর্থন করবে না।

ত্রুটিগুলি ধরার জন্য এবং আপনি speak() সঠিকভাবে কল করছেন কিনা তা নিশ্চিত করার জন্য, একটি কলব্যাক ফাংশন পাস করুন যা কোনও আর্গুমেন্ট নেয় না। কলব্যাকের ভিতরে, কোনও ত্রুটি আছে কিনা তা দেখতে runtime.lastError পরীক্ষা করুন।

chrome.tts.speak(
  utterance,
  options,
  function() {
    if (chrome.runtime.lastError) {
      console.log('Error: ' + chrome.runtime.lastError.message);
    }
  }
);

ইঞ্জিন স্পিচ তৈরি করা শুরু করার আগেই কলব্যাকটি ফিরে আসে। কলব্যাকের উদ্দেশ্য হল TTS API ব্যবহারের সময় সিনট্যাক্স ত্রুটি সম্পর্কে আপনাকে সতর্ক করা, স্পিচ সংশ্লেষণ এবং আউটপুট করার প্রক্রিয়ায় ঘটতে পারে এমন সমস্ত সম্ভাব্য ত্রুটি ধরা না। এই ত্রুটিগুলি ধরার জন্যও, আপনাকে পরবর্তী বিভাগে বর্ণিত একটি ইভেন্ট লিসেনার ব্যবহার করতে হবে।

ঘটনাগুলো শুনুন

সংশ্লেষিত বক্তৃতার অবস্থা সম্পর্কে আরও রিয়েল-টাইম তথ্য পেতে, to speak() বিকল্পগুলিতে একটি ইভেন্ট লিসেনার পাস করুন, যেমন:

chrome.tts.speak(
  utterance,
  {
    onEvent: function(event) {
      console.log('Event ' + event.type + ' at position ' + event.charIndex);
      if (event.type == 'error') {
        console.log('Error: ' + event.errorMessage);
      }
    }
  },
  callback
);

প্রতিটি ইভেন্টে একটি ইভেন্ট টাইপ থাকে, উচ্চারণের সাপেক্ষে বর্তমান বক্তৃতার অক্ষর সূচক, এবং ত্রুটি ইভেন্টের জন্য, একটি ঐচ্ছিক ত্রুটি বার্তা থাকে। ইভেন্টের ধরণগুলি হল:

• 'start' : ইঞ্জিনটি উচ্চারণটি বলতে শুরু করেছে।
• 'word' : একটি শব্দ সীমানায় পৌঁছে গেছে। বর্তমান বক্তৃতা অবস্থান নির্ধারণ করতে event.charIndex ব্যবহার করুন।
• 'sentence' : বাক্যের সীমানায় পৌঁছে গেছে। বর্তমান বক্তৃতার অবস্থান নির্ধারণ করতে event.charIndex ব্যবহার করুন।
• 'marker' : একটি SSML মার্কারে পৌঁছেছে। বর্তমান স্পিচ অবস্থান নির্ধারণ করতে event.charIndex ব্যবহার করুন।
• 'end' : ইঞ্জিনটি উচ্চারণটি বলা শেষ করেছে।
• 'interrupted' : এই উচ্চারণটি আরেকটি কল টু speak() অথবা stop() দ্বারা বাধাগ্রস্ত হয়েছিল এবং শেষ হয়নি।
• 'cancelled' : এই উচ্চারণটি সারিবদ্ধ ছিল, কিন্তু তারপর অন্য একটি কল টু speak() বা stop() দ্বারা বাতিল করা হয়েছিল এবং কখনও কথা বলা শুরু করেনি।
• 'error' : একটি ইঞ্জিন-নির্দিষ্ট ত্রুটি ঘটেছে এবং এই উচ্চারণটি বলা যাচ্ছে না। বিস্তারিত জানার জন্য event.errorMessage দেখুন।

চারটি ইভেন্টের ধরণ— 'end' , 'interrupted' , 'cancelled' , এবং 'error' — চূড়ান্ত । এই ইভেন্টগুলির মধ্যে একটি পাওয়ার পরে, এই উচ্চারণটি আর কথা বলবে না এবং এই উচ্চারণ থেকে কোনও নতুন ইভেন্ট গ্রহণ করা হবে না।

কিছু ভয়েস সব ধরণের ইভেন্ট সাপোর্ট নাও করতে পারে, এবং কিছু ভয়েস কোনও ইভেন্টই পাঠাতে পারে না। যদি আপনি কোনও ভয়েস ব্যবহার করতে না চান যদি না এটি নির্দিষ্ট ইভেন্ট পাঠায়, তাহলে অপশন অবজেক্টের requiredEventTypes সদস্যে আপনার প্রয়োজনীয় ইভেন্টগুলি পাস করুন, অথবা getVoices() ব্যবহার করে আপনার প্রয়োজনীয়তা পূরণ করে এমন একটি ভয়েস বেছে নিন। উভয়ের বর্ণনা নিম্নলিখিত অংশে দেওয়া হয়েছে।

SSML মার্কআপ

এই API-তে ব্যবহৃত উচ্চারণগুলিতে স্পিচ সিনথেসিস মার্কআপ ল্যাঙ্গুয়েজ (SSML) ব্যবহার করে মার্কআপ অন্তর্ভুক্ত থাকতে পারে। যদি আপনি SSML ব্যবহার করেন, তাহলে speak() এর প্রথম যুক্তিটি একটি সম্পূর্ণ SSML ডকুমেন্ট হওয়া উচিত যার একটি XML হেডার এবং একটি শীর্ষ-স্তরের <speak> ট্যাগ থাকবে, কোনও ডকুমেন্ট ফ্র্যাগমেন্ট নয়।

উদাহরণস্বরূপ:

chrome.tts.speak(
  '<?xml version="1.0"?>' +
  '<speak>' +
  '  The <emphasis>second</emphasis> ' +
  '  word of this sentence was emphasized.' +
  '</speak>'
);

সব স্পিচ ইঞ্জিন সব SSML ট্যাগ সমর্থন করবে না, এবং কিছু কিছু SSML একেবারেই সমর্থন নাও করতে পারে, তবে সব ইঞ্জিনকে এমন যেকোনো SSML উপেক্ষা করতে হবে যা তারা সমর্থন করে না এবং তবুও অন্তর্নিহিত টেক্সট বলতে হবে।

একটি ভয়েস বেছে নিন

ডিফল্টরূপে, Chrome আপনার পছন্দের প্রতিটি উচ্চারণের জন্য, ভাষার উপর ভিত্তি করে সবচেয়ে উপযুক্ত ভয়েস বেছে নেয়। বেশিরভাগ Windows, Mac OS X এবং ChromeOS সিস্টেমে, অপারেটিং সিস্টেম দ্বারা সরবরাহিত স্পিচ সংশ্লেষণ কমপক্ষে একটি ভাষায় যেকোনো টেক্সট বলতে সক্ষম হওয়া উচিত। তবে কিছু ব্যবহারকারীর কাছে তাদের অপারেটিং সিস্টেম এবং অন্যান্য Chrome এক্সটেনশন দ্বারা বাস্তবায়িত স্পিচ ইঞ্জিন থেকে বিভিন্ন ধরণের ভয়েস উপলব্ধ থাকতে পারে। এই ক্ষেত্রে, আপনি উপযুক্ত ভয়েস চয়ন করতে বা ব্যবহারকারীকে পছন্দের তালিকা উপস্থাপন করতে কাস্টম কোড প্রয়োগ করতে পারেন।

সকল ভয়েসের তালিকা পেতে, getVoices() কল করুন এবং এটিকে একটি ফাংশন দিন যা TtsVoice অবজেক্টের একটি অ্যারেকে তার আর্গুমেন্ট হিসেবে গ্রহণ করে:

chrome.tts.getVoices(
  function(voices) {
    for (var i = 0; i < voices.length; i++) {
      console.log('Voice ' + i + ':');
      console.log('  name: ' + voices[i].voiceName);
      console.log('  lang: ' + voices[i].lang);
      console.log('  extension id: ' + voices[i].extensionId);
      console.log('  event types: ' + voices[i].eventTypes);
    }
  }
);

chrome.tts.getVoices(): Promise<TtsVoice[]>

chrome.tts.isSpeaking(): Promise<boolean>

chrome.tts.pause(): void

chrome.tts.resume(): void

chrome.tts.speak(
  utterance: string,
  options?: TtsOptions,
): Promise<void>

chrome.tts.stop(): void

chrome.tts.onVoicesChanged.addListener(
  callback: function,
)