chrome.ttsEngine

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

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

สิทธิ์

ttsEngine

สิทธิ์นี้จะทริกเกอร์คำเตือน

ภาพรวม

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

ไฟล์ Manifest

หากต้องการใช้เครื่องมือ 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 โดยสมมติว่าคุณได้ลงทะเบียน Listener เหตุการณ์เสียงพูดตามที่อธิบายไว้ด้านล่าง

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

หากต้องการสร้างคำพูดตามคำขอของไคลเอ็นต์ ส่วนขยายของคุณต้องลงทะเบียน Listener สำหรับทั้ง 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);

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

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

ประเภท

AudioBuffer

Chrome 92 ขึ้นไป

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

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

• audioBuffer

  ArrayBuffer

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

• charIndex

  number ไม่บังคับ

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

• isLastBuffer

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

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

AudioStreamOptions

Chrome 92 ขึ้นไป

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

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

• bufferSize

  ตัวเลข

  จำนวนตัวอย่างภายในบัฟเฟอร์เสียง

• sampleRate

  ตัวเลข

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

LanguageInstallStatus

Chrome 132 ขึ้นไป

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

ค่าแจกแจง

"notInstalled"

"กำลังติดตั้ง"

"installed"

"failed"

LanguageStatus

Chrome 132 ขึ้นไป

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

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

• ข้อผิดพลาด

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

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

• installStatus

  LanguageInstallStatus

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

• lang

  สตริง

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

LanguageUninstallOptions

Chrome 132 ขึ้นไป

ตัวเลือกสำหรับการถอนการติดตั้งภาษาที่ระบุ

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

• uninstallImmediately

  บูลีน

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

SpeakOptions

Chrome 92 ขึ้นไป

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

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

• gender

  VoiceGender ไม่บังคับ

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

  เลิกใช้งานเพศแล้วและระบบจะไม่สนใจ

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

• lang

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

  ภาษาที่จะใช้สำหรับการสังเคราะห์ ในรูปแบบภาษา-ภูมิภาค ตัวอย่าง: 'en', 'en-US', 'en-GB', 'zh-CN'

• พิช

  number ไม่บังคับ

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

• อัตรา

  number ไม่บังคับ

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

• voiceName

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

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

• ระดับเสียง

  number ไม่บังคับ

  ระดับเสียงพูดระหว่าง 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 132 ขึ้นไป

chrome.ttsEngine.updateLanguage(
  status: LanguageStatus,
): void

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

พารามิเตอร์

• สถานะ

  LanguageStatus

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

updateVoices()

Chrome 66 ขึ้นไป

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

เรียกใช้โดยเครื่องมือเพื่ออัปเดตรายการเสียง รายการนี้จะลบล้างเสียงที่ประกาศไว้ในไฟล์ 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 132 ขึ้นไป

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 ของส่วนขยายนี้เป็นเสียงแรกที่ตรงกับออบเจ็กต์ตัวเลือก

พารามิเตอร์

• 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 ของส่วนขยายนี้เป็นเสียงแรกที่ตรงกับออบเจ็กต์ตัวเลือก แตกต่างจาก 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 132 ขึ้นไป

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

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

พารามิเตอร์

• callback

  ฟังก์ชัน

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

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

  • ผู้ส่งคำขอ

    TtsClient

  • lang

    สตริง

  • uninstallOptions

    LanguageUninstallOptions