chrome.ttsEngine

คำอธิบาย

ใช้ chrome.ttsEngine API เพื่อติดตั้งใช้งานเครื่องมือการอ่านออกเสียงข้อความ(TTS) โดยใช้ส่วนขยาย หากส่วนขยายลงทะเบียนโดยใช้ API นี้ ก็จะได้รับการแจ้งเตือนเหตุการณ์ที่มีข้อความที่จะพูดและพารามิเตอร์อื่นๆ เมื่อส่วนขยายหรือแอป Chrome ใช้ tts API เพื่อสร้างเสียงพูด จากนั้นส่วนขยายจะใช้เทคโนโลยีเว็บที่มีอยู่เพื่อสังเคราะห์และแสดงออกเสียง และส่งเหตุการณ์กลับไปยังฟังก์ชันการเรียกเพื่อรายงานสถานะ

สิทธิ์

ttsEngine

แนวคิดและการใช้งาน

ส่วนขยายสามารถลงทะเบียนตัวเองเป็นเครื่องมือพูดได้ ซึ่งจะช่วยให้สามารถขัดขวางการเรียกใช้ฟังก์ชันบางอย่างหรือทั้งหมด เช่น tts.speak() และ tts.stop() และแสดงการใช้งานทางเลือก ส่วนขยายสามารถใช้เทคโนโลยีเว็บที่มีอยู่เพื่อแสดงเสียงพูดได้ฟรี ซึ่งรวมถึงการสตรีมเสียงจากเซิร์ฟเวอร์และเสียง HTML5 ส่วนขยายอาจทําสิ่งอื่นกับคําพูดด้วย เช่น แสดงคำบรรยายแทนเสียงในป๊อปอัป หรือส่งคำบรรยายแทนเสียงเป็นข้อความบันทึกไปยังเซิร์ฟเวอร์ระยะไกล

หากต้องการใช้เครื่องมือ TTS ส่วนขยายต้องประกาศสิทธิ์ "ttsEngine" แล้วประกาศเสียงทั้งหมดที่มีในไฟล์ Manifest ของส่วนขยาย ดังนี้

{
  "name": "My TTS Engine",
  "version": "1.0",
  "permissions": ["ttsEngine"],
  "tts_engine": {
    "voices": [
      {
        "voice_name": "Alice",
        "lang": "en-US",
        "event_types": ["start", "marker", "end"]
      },
      {
        "voice_name": "Pat",
        "lang": "en-US",
        "event_types": ["end"]
      }
    ]
  },
  "background": {
    "page": "background.html",
    "persistent": false
  }
}

ส่วนขยายสามารถระบุเสียงได้เท่าใดก็ได้

ต้องระบุพารามิเตอร์ voice_name ชื่อควรสื่อความหมายมากพอที่จะระบุชื่อเสียงและเครื่องมือที่ใช้ ในกรณีที่ส่วนขยาย 2 รายการลงทะเบียนเสียงที่มีชื่อเดียวกัน ซึ่งเป็นกรณีที่พบไม่บ่อยนัก ไคลเอ็นต์สามารถระบุรหัสของส่วนขยายที่ควรทำการสังเคราะห์เสียง

พารามิเตอร์ lang ไม่บังคับ แต่เราขอแนะนำอย่างยิ่งให้ระบุ เสียงส่วนใหญ่จะสังเคราะห์เสียงพูดได้เพียงภาษาเดียว เมื่อเครื่องมือรองรับมากกว่า 1 ภาษา เครื่องมือจะลงทะเบียนเสียงแยกกันสำหรับแต่ละภาษาได้โดยง่าย ในกรณีที่หายากที่เสียงเดียวจะจัดการได้มากกว่า 1 ภาษา วิธีง่ายที่สุดคือระบุเสียง 2 รายการแยกกันและจัดการโดยใช้ตรรกะเดียวกันภายใน อย่างไรก็ตาม หากต้องการสร้างเสียงที่จะจัดการกับคำพูดในภาษาใดก็ได้ ให้ยกเว้นพารามิเตอร์ lang ออกจากไฟล์ Manifest ของส่วนขยาย

สุดท้าย พารามิเตอร์ event_types เป็นสิ่งที่ต้องใช้หากเครื่องมือสามารถส่งเหตุการณ์เพื่ออัปเดตความคืบหน้าในการสังเคราะห์เสียงให้กับไคลเอ็นต์ได้ เราขอแนะนำให้รองรับประเภทเหตุการณ์ 'end' เป็นอย่างน้อยเพื่อระบุว่าเมื่อพูดจบแล้ว ไม่เช่นนั้น Chrome จะกำหนดเวลาคําพูดที่รอดำเนินการไม่ได้

เมื่อโหลดแล้ว ส่วนขยายจะแทนที่รายการเสียงที่ประกาศไว้ได้โดยเรียกใช้ chrome.ttsEngine.updateVoices (โปรดทราบว่าพารามิเตอร์ที่ใช้ในการเรียกใช้แบบเป็นโปรแกรมเพื่อเรียกใช้updateVoicesอยู่ในรูปแบบ Camel Case เช่น voiceName ซึ่งแตกต่างจากไฟล์ Manifest ที่ใช้ voice_name)

หมายเหตุ: หากเครื่องมือ TTS ไม่รองรับประเภทเหตุการณ์ 'end' ทาง Chrome จะจัดคิวคำพูดไม่ได้เนื่องจากไม่รู้เมื่อคำพูดของคุณสิ้นสุดลง Chrome จะส่งตัวเลือกบูลีน enqueue เพิ่มเติมไปยังตัวแฮนเดิล onSpeak ของเครื่องยนต์เพื่อช่วยลดความล่าช้านี้ ซึ่งจะช่วยให้คุณมีตัวเลือกในการใช้คิวของคุณเอง เราไม่แนะนําให้ใช้วิธีนี้เนื่องจากไคลเอ็นต์จะจัดคิวคําพูดที่ควรออกเสียงโดยเครื่องมือพูดที่แตกต่างกันไม่ได้

ประเภทเหตุการณ์ที่เป็นไปได้ซึ่งคุณส่งได้จะสอดคล้องกับประเภทเหตุการณ์ที่เมธอด speak() รับ

• 'start': เครื่องยนต์เริ่มพูดข้อความแล้ว
• 'word': สิ้นสุดที่ขอบคำ ใช้ event.charIndex เพื่อระบุตําแหน่งการพูดปัจจุบัน
• 'sentence': สิ้นสุดประโยค ใช้ event.charIndex เพื่อระบุตำแหน่งการพูดปัจจุบัน
• 'marker': พบเครื่องหมาย SSML ใช้ event.charIndex เพื่อระบุตําแหน่งการพูดปัจจุบัน
• 'end': เครื่องยนต์อ่านออกเสียงข้อความเสร็จแล้ว
• 'error': เกิดข้อผิดพลาดเฉพาะเครื่องมือและไม่สามารถพูดข้อความนี้ ส่งข้อมูลเพิ่มเติมใน event.errorMessage

เหตุการณ์ 'interrupted' และ 'cancelled' ไม่ได้ส่งโดยเครื่องมือพูด แต่ Chrome จะสร้างเหตุการณ์เหล่านี้ให้โดยอัตโนมัติ

โปรแกรมเปลี่ยนข้อความเป็นเสียงสามารถรับข้อมูลเสียงจากไฟล์ Manifest ของส่วนขยายได้โดยเรียกใช้ tts.getVoices สมมติว่าคุณได้ลงทะเบียนโปรแกรมรับฟังเหตุการณ์เสียงตามที่อธิบายไว้ด้านล่าง

จัดการเหตุการณ์การพูด

หากต้องการสร้างเสียงตามคำขอของลูกค้า ส่วนขยายของคุณต้องลงทะเบียนผู้ฟังสำหรับทั้ง onSpeak และ onStop ดังนี้

const speakListener = (utterance, options, sendTtsEvent) => {
  sendTtsEvent({type: 'start', charIndex: 0})

  // (start speaking)

  sendTtsEvent({type: 'end', charIndex: utterance.length})
};

const stopListener = () => {
  // (stop all speech)
};

chrome.ttsEngine.onSpeak.addListener(speakListener);
chrome.ttsEngine.onStop.addListener(stopListener);

ข้อควรระวัง: หากส่วนขยายไม่ได้ลงทะเบียนผู้ฟังสำหรับทั้ง onSpeak และ onStop ส่วนขยายจะไม่ขัดจังหวะการเรียกใช้เสียงพูด ไม่ว่าข้อมูลในไฟล์ Manifest จะเป็นอย่างไรก็ตาม

การตัดสินใจว่าจะส่งคําขอพูดไปยังส่วนขยายหรือไม่นั้นขึ้นอยู่กับว่าส่วนขยายรองรับพารามิเตอร์เสียงที่ระบุในไฟล์ Manifest หรือไม่ และมีการลงทะเบียน onSpeak และ onStop ไว้หรือไม่ กล่าวคือ ชิ้นงานส่วนขยายจะไม่สามารถรับคำขอคำพูดและตัดสินใจแบบไดนามิกว่าจะจัดการคำขอหรือไม่

ประเภท

AudioBuffer

Chrome 92 ขึ้นไป

พารามิเตอร์ที่มีบัฟเฟอร์เสียงและข้อมูลที่เชื่อมโยง

พร็อพเพอร์ตี้

• audioBuffer

  ArrayBuffer

  บัฟเฟอร์เสียงจากเครื่องมืออ่านออกเสียงข้อความ โดยควรมีความยาวเท่ากับ audioStreamOptions.bufferSize และเข้ารหัสเป็นโมโนที่ audioStreamOptions.sampleRate และเป็นแบบ PCM แบบเชิงเส้น 32 บิตที่มีค่าของทศนิยม เช่น ประเภท Float32Array ใน JavaScript

• charIndex

  ตัวเลข ไม่บังคับ

  ดัชนีอักขระที่เชื่อมโยงกับบัฟเฟอร์เสียงนี้

• isLastBuffer

  บูลีน ไม่บังคับ

  จริงหากบัฟเฟอร์เสียงนี้เป็นบัฟเฟอร์สุดท้ายของข้อความที่กำลังอ่าน

AudioStreamOptions

Chrome 92 ขึ้นไป

มีรูปแบบสตรีมเสียงที่คาดว่าจะผลิตโดยเครื่องมือ

พร็อพเพอร์ตี้

• bufferSize

  ตัวเลข

  จํานวนแซมเปิลภายในบัฟเฟอร์เสียง

• sampleRate

  ตัวเลข

  อัตราการสุ่มตัวอย่างที่คาดไว้ในบัฟเฟอร์เสียง

LanguageInstallStatus

รอดำเนินการ

สถานะการติดตั้งเสียง

ค่าแจกแจง

"notInstalled"

"installing"

"installed"

"failed"

LanguageStatus

รอดำเนินการ

สถานะการติดตั้งภาษา

พร็อพเพอร์ตี้

• ข้อผิดพลาด

  สตริง ไม่บังคับ

  รายละเอียดเกี่ยวกับการติดตั้งที่ไม่สำเร็จ ตัวเลือกที่ระบบจะป้อนข้อมูลให้หากติดตั้งภาษาไม่สำเร็จ

• installStatus

  LanguageInstallStatus

  สถานะการติดตั้ง

• lang

  สตริง

  สตริงภาษาในรูปแบบรหัสภาษา-รหัสภูมิภาค โดยอาจไม่ใส่รหัสภูมิภาคก็ได้ เช่น en, en-AU, zh-CH

LanguageUninstallOptions

รอดำเนินการ

ตัวเลือกในการถอนการติดตั้งภาษาหนึ่งๆ

พร็อพเพอร์ตี้

• uninstallImmediately

  บูลีน

  จริงหากไคลเอ็นต์ TTS ต้องการถอนการติดตั้งภาษาทันที เครื่องมืออาจเลือกว่าจะถอนการติดตั้งภาษาหรือไม่และเมื่อใด โดยอิงตามพารามิเตอร์นี้และข้อมูลผู้ขอ หากเป็นเท็จ ระบบอาจใช้เกณฑ์อื่นๆ เช่น การใช้งานล่าสุด เพื่อกำหนดเวลาถอนการติดตั้ง

SpeakOptions

Chrome 92 ขึ้นไป

ตัวเลือกที่ระบุให้กับเมธอด tts.speak()

พร็อพเพอร์ตี้

• gender

  VoiceGender ไม่บังคับ

  เลิกใช้งานแล้วตั้งแต่ Chrome 92

  ระบบจะไม่สนใจเพศ

  เพศของเสียงสำหรับเสียงสังเคราะห์

• lang

  สตริง ไม่บังคับ

  ภาษาที่จะใช้สังเคราะห์ในรูปแบบ language-region ตัวอย่างเช่น "en", "en-US", "en-GB", "zh-CN"

• พิช

  ตัวเลข ไม่บังคับ

  ความสูงของเสียงพูดระหว่าง 0 ถึง 2 โดยที่ 0 คือต่ำสุดและ 2 คือสูงสุด 1.0 สอดคล้องกับระดับเสียงเริ่มต้นของเสียงนี้

• อัตรา

  ตัวเลข ไม่บังคับ

  ความเร็วในการพูดสัมพันธ์กับความเร็วเริ่มต้นของเสียงนี้ 1.0 คืออัตราเริ่มต้น ซึ่งปกติจะอยู่ที่ประมาณ 180 ถึง 220 คำต่อนาที 2.0 คือเร็วขึ้น 2 เท่า และ 0.5 คือช้าลงครึ่งหนึ่ง ค่านี้ต้องอยู่ระหว่าง 0.1 ถึง 10.0 (รวม) เมื่อเสียงไม่รองรับอัตราค่าบริการที่หลากหลายนี้ อย่าแสดงข้อผิดพลาด แต่ให้ตัดอัตราเป็นช่วงที่เสียงรองรับแทน

• voiceName

  สตริง ไม่บังคับ

  ชื่อเสียงที่จะใช้สังเคราะห์

• ระดับเสียง

  ตัวเลข ไม่บังคับ

  ระดับเสียงพูดระหว่าง 0 ถึง 1 โดยที่ 0 คือต่ำสุดและ 1 คือสูงสุด โดยค่าเริ่มต้นคือ 1.0

TtsClient

Chrome 131 ขึ้นไป

ตัวระบุสถานะการขอของลูกค้า

พร็อพเพอร์ตี้

• id

  สตริง

  ไคลเอ็นต์ส่งคําขอการจัดการภาษา สําหรับส่วนขยาย จะเป็นรหัสส่วนขยายที่ไม่ซ้ำกัน สำหรับฟีเจอร์ของ Chrome ค่านี้คือชื่อที่มนุษย์อ่านได้ของฟีเจอร์

• source

  TtsClientSource

  ประเภทผู้ขอ

TtsClientSource

Chrome 131 ขึ้นไป

ประเภทผู้ขอ

ค่าแจกแจง

"chromefeature"

"extension"

VoiceGender

Chrome 54 ขึ้นไป เลิกใช้งานตั้งแต่ Chrome 70

ระบบจะไม่สนใจเพศ

ค่าแจกแจง

"male"

"female"

เมธอด

updateLanguage()

รอดำเนินการ

chrome.ttsEngine.updateLanguage(
  status: LanguageStatus,
)

เรียกโดยเครื่องมือเมื่อพยายามติดตั้งภาษาและเมื่อถอนการติดตั้งภาษา หรือที่เรียกว่าการตอบสนองต่อคำขอสถานะจากลูกค้า เมื่อติดตั้งหรือถอนการติดตั้งเสียง เครื่องมือควรเรียก ttsEngine.updateVoices เพื่อลงทะเบียนเสียงด้วย

พารามิเตอร์

• สถานะ

  LanguageStatus

  สถานะการติดตั้งภาษา

updateVoices()

Chrome 66 ขึ้นไป

chrome.ttsEngine.updateVoices(
  voices: TtsVoice[],
)

เรียกใช้โดยเครื่องมือเพื่ออัปเดตรายการเสียง รายการนี้จะลบล้างเสียงที่ประกาศไว้ในไฟล์ Manifest ของส่วนขยายนี้

พารามิเตอร์

• เสียง

  TtsVoice[]

  อาร์เรย์ของออบเจ็กต์ tts.TtsVoice ที่แสดงเสียงที่ใช้ได้สำหรับการสังเคราะห์เสียง

กิจกรรม

onInstallLanguageRequest

Chrome 131 ขึ้นไป

chrome.ttsEngine.onInstallLanguageRequest.addListener(
  callback: function,
)

เรียกใช้เมื่อไคลเอ็นต์ TTS ขอติดตั้งภาษาใหม่ เครื่องมือควรพยายามดาวน์โหลดและติดตั้งภาษา และเรียก ttsEngine.updateLanguage พร้อมผลลัพธ์ หากดำเนินการสำเร็จ เครื่องมือควรเรียก ttsEngine.updateVoices เพื่อลงทะเบียนเสียงที่พร้อมใช้งานใหม่ด้วย

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (requestor: TtsClient, lang: string) => void

  • ผู้ขอ

    TtsClient

  • lang

    สตริง

onLanguageStatusRequest

รอดำเนินการ

chrome.ttsEngine.onLanguageStatusRequest.addListener(
  callback: function,
)

เริ่มทํางานเมื่อไคลเอ็นต์ TTS ขอสถานะการติดตั้งภาษา

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (requestor: TtsClient, lang: string) => void

  • ผู้ขอ

    TtsClient

  • lang

    สตริง

onPause

chrome.ttsEngine.onPause.addListener(
  callback: function,
)

ไม่บังคับ: หากเครื่องมือรองรับเหตุการณ์หยุดชั่วคราว เครื่องมือควรหยุดคำพูดที่กำลังพูดอยู่ชั่วคราว (หากมี) จนกว่าจะได้รับการหยุดชั่วคราวหรือเหตุการณ์หยุด โปรดทราบว่าเหตุการณ์หยุดควรล้างสถานะหยุดชั่วคราวด้วย

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

onResume

chrome.ttsEngine.onResume.addListener(
  callback: function,
)

ไม่บังคับ: หากเครื่องมือรองรับเหตุการณ์ "หยุดชั่วคราว" ก็ควรรองรับเหตุการณ์ "เล่นต่อ" ด้วย เพื่อพูดข้อความพูดปัจจุบันต่อ (หากมี) โปรดทราบว่าเหตุการณ์หยุดควรล้างสถานะหยุดชั่วคราวด้วย

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

onSpeak

chrome.ttsEngine.onSpeak.addListener(
  callback: function,
)

เรียกใช้เมื่อผู้ใช้เรียกใช้ tts.speak() และเสียงใดเสียงหนึ่งจากไฟล์ Manifest ของส่วนขยายนี้เป็นเสียงแรกที่ตรงกับออบเจ็กต์ options

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (utterance: string, options: SpeakOptions, sendTtsEvent: function) => void

  • ข้อความ

    สตริง

  • ตัวเลือก

    SpeakOptions

  • sendTtsEvent

    ฟังก์ชัน

    พารามิเตอร์ sendTtsEvent จะมีลักษณะดังนี้

    (event: tts.TtsEvent) => void

    • เหตุการณ์

      tts.TtsEvent

      เหตุการณ์จากเครื่องมืออ่านออกเสียงข้อความที่ระบุสถานะของการพูดนี้

onSpeakWithAudioStream

Chrome 92 ขึ้นไป

chrome.ttsEngine.onSpeakWithAudioStream.addListener(
  callback: function,
)

เรียกใช้เมื่อผู้ใช้เรียกใช้ tts.speak() และเสียงใดเสียงหนึ่งจากไฟล์ Manifest ของส่วนขยายนี้เป็นเสียงแรกที่ตรงกับออบเจ็กต์ options แตกต่างจาก ttsEngine.onSpeak ตรงที่ Chrome มีบริการเล่นเสียงและจัดการการส่งเหตุการณ์ TTS

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (utterance: string, options: SpeakOptions, audioStreamOptions: AudioStreamOptions, sendTtsAudio: function, sendError: function) => void

  • ข้อความ

    สตริง

  • ตัวเลือก

    SpeakOptions

  • audioStreamOptions

    AudioStreamOptions

  • sendTtsAudio

    ฟังก์ชัน

    พารามิเตอร์ sendTtsAudio จะมีลักษณะดังนี้

    (audioBufferParams: AudioBuffer) => void

    • audioBufferParams

      AudioBuffer

      พารามิเตอร์ที่มีบัฟเฟอร์เสียงและข้อมูลที่เชื่อมโยง

  • sendError

    ฟังก์ชัน

    Chrome 94 ขึ้นไป

    พารามิเตอร์ sendError จะมีลักษณะดังนี้

    (errorMessage?: string) => void

    • errorMessage

      สตริง ไม่บังคับ

      สตริงที่อธิบายข้อผิดพลาด

onStop

chrome.ttsEngine.onStop.addListener(
  callback: function,
)

เรียกใช้เมื่อมีสายเรียกเข้า tts.stop และส่วนขยายนี้อาจกำลังพูดอยู่ หากส่วนขยายได้รับการเรียกใช้ onStop และเสียงหยุดไปแล้ว ส่วนขยายไม่ควรดำเนินการใดๆ (ไม่แสดงข้อผิดพลาด) หากเสียงพูดอยู่ในสถานะหยุดชั่วคราว การดำเนินการนี้ควรยกเลิกสถานะหยุดชั่วคราว

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  () => void

onUninstallLanguageRequest

รอดำเนินการ

chrome.ttsEngine.onUninstallLanguageRequest.addListener(
  callback: function,
)

เรียกใช้เมื่อไคลเอ็นต์ TTS ระบุว่าไม่จําเป็นต้องใช้ภาษาอีกต่อไป

พารามิเตอร์

• Callback

  ฟังก์ชัน

  พารามิเตอร์ callback จะมีลักษณะดังนี้

  (requestor: TtsClient, lang: string, uninstallOptions: LanguageUninstallOptions) => void

  • ผู้ขอ

    TtsClient

  • lang

    สตริง

  • uninstallOptions

    LanguageUninstallOptions