Các tiện ích Manifest V2 đã bị gỡ khỏi Cửa hàng Chrome trực tuyến vào ngày 31 tháng 8 năm 2026. Hãy di chuyển tiện ích của bạn sang Manifest V3 để người dùng có thể sử dụng lại tiện ích.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

chrome.ttsEngine

refresh date: 2026-09-25 robots: noindex

Mô tả

Sử dụng API chrome.ttsEngine để triển khai công cụ chuyển văn bản sang lời nói(TTS) bằng một tiện ích. Nếu tiện ích của bạn đăng ký bằng API này, thì tiện ích đó sẽ nhận được các sự kiện chứa một câu nói cần được phát âm và các tham số khác khi bất kỳ tiện ích hoặc Ứng dụng Chrome nào sử dụng API tts để tạo lời nói. Sau đó, tiện ích của bạn có thể sử dụng bất kỳ công nghệ web nào có sẵn để tổng hợp và xuất lời nói, đồng thời gửi sự kiện trở lại hàm gọi để báo cáo trạng thái.

Quyền

ttsEngine

Tổng quan

Tiện ích có thể tự đăng ký làm công cụ chuyển văn bản sang lời nói. Bằng cách này, nó có thể chặn một số hoặc tất cả lệnh gọi đến các hàm như tts.speak và tts.stop, đồng thời cung cấp một phương thức triển khai thay thế. Tiện ích có thể sử dụng bất kỳ công nghệ web nào hiện có để cung cấp lời nói, bao gồm cả âm thanh trực tuyến từ máy chủ, âm thanh HTML5. Tiện ích thậm chí có thể làm điều gì đó khác với các câu nói, chẳng hạn như hiển thị phụ đề trong cửa sổ bật lên hoặc gửi chúng dưới dạng thông điệp nhật ký đến máy chủ từ xa.

Tệp kê khai

Để triển khai công cụ TTS, tiện ích phải khai báo quyền "ttsEngine" rồi khai báo tất cả giọng nói mà tiện ích cung cấp trong tệp kê khai tiện ích, như sau:

{
  "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
  }
}

Một tiện ích có thể chỉ định số lượng giọng nói bất kỳ.

Tham số voice_name là bắt buộc. Tên phải đủ mang tính mô tả để xác định tên của giọng nói và công cụ được sử dụng. Trong trường hợp hiếm hoi khi hai tiện ích đăng ký giọng nói có cùng tên, ứng dụng có thể chỉ định mã nhận dạng của tiện ích sẽ thực hiện quá trình tổng hợp.

Tham số lang không bắt buộc nhưng bạn nên dùng. Hầu như lúc nào giọng nói cũng có thể tổng hợp lời nói chỉ bằng một ngôn ngữ. Khi một công cụ hỗ trợ nhiều ngôn ngữ, công cụ đó có thể dễ dàng đăng ký một giọng nói riêng cho từng ngôn ngữ. Trong một số ít trường hợp, một giọng nói có thể xử lý nhiều ngôn ngữ, cách dễ nhất là chỉ cần liệt kê hai giọng nói riêng biệt và xử lý chúng bằng cùng một logic nội bộ. Tuy nhiên, nếu bạn muốn tạo một giọng nói có thể xử lý các câu nói bằng bất kỳ ngôn ngữ nào, hãy bỏ tham số lang khỏi tệp kê khai của tiện ích.

Cuối cùng, tham số event_types là bắt buộc nếu công cụ có thể gửi sự kiện để cập nhật cho ứng dụng về tiến trình tổng hợp lời nói. Bạn nên hỗ trợ loại sự kiện 'end' để cho biết thời điểm lời nói kết thúc, nếu không, Chrome sẽ không thể lên lịch cho các câu nói trong hàng đợi.

Sau khi tải, tiện ích có thể thay thế danh sách giọng nói đã khai báo bằng cách gọi chrome.ttsEngine.updateVoices. (Xin lưu ý rằng các tham số được dùng trong lệnh gọi có lập trình đến updateVoices được viết theo kiểu viết lạc đà (viết liền và phân tách bằng chữ cái viết hoa): ví dụ: voiceName, không giống như tệp kê khai sử dụng voice_name.)

Lưu ý: Nếu công cụ TTS của bạn không hỗ trợ loại sự kiện 'end', thì Chrome không thể đưa các câu nói vào hàng đợi vì không có cách nào để biết khi nào câu nói của bạn kết thúc. Để giúp giảm thiểu vấn đề này, Chrome sẽ truyền thêm một tuỳ chọn boolean enqueue đến trình xử lý onSpeak của công cụ, cho phép bạn triển khai hàng đợi của riêng mình. Bạn không nên làm như vậy vì khi đó, ứng dụng không thể đưa các câu nói cần được phát âm bằng các công cụ lời nói khác nhau vào hàng đợi.

Các loại sự kiện có thể gửi tương ứng với các loại sự kiện mà phương thức speak() nhận được:

'start': Công cụ đã bắt đầu đọc câu nói.
'word': Đã đạt đến ranh giới từ. Sử dụng event.charIndex để xác định vị trí lời nói hiện tại.
'sentence': Đã đạt đến ranh giới câu. Dùng event.charIndex để xác định vị trí lời nói hiện tại.
'marker': Đã đạt đến điểm đánh dấu SSML. Sử dụng event.charIndex để xác định vị trí lời nói hiện tại.
'end': Công cụ đã nói xong câu nói.
'error': Đã xảy ra lỗi dành riêng cho công cụ và không thể nói câu nói này. Truyền thêm thông tin trong event.errorMessage.

Công cụ lời nói không gửi các sự kiện 'interrupted' và 'cancelled'; các sự kiện này được Chrome tạo tự động.

Ứng dụng chuyển văn bản sang lời nói có thể lấy thông tin giọng nói từ tệp kê khai của tiện ích bằng cách gọi tts.getVoices, giả sử bạn đã đăng ký trình nghe sự kiện lời nói như mô tả bên dưới.

Xử lý sự kiện lời nói

Để tạo lời nói theo yêu cầu của ứng dụng, tiện ích của bạn phải đăng ký trình nghe cho cả onSpeak và onStop, như sau:

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);

Cảnh báo: Nếu tiện ích của bạn không đăng ký trình nghe cho cả onSpeak và onStop, thì tiện ích đó sẽ không chặn bất kỳ lệnh gọi lời nói nào, bất kể nội dung trong tệp kê khai là gì.

Quyết định có gửi một yêu cầu giọng nói nhất định đến một tiện ích hay không hoàn toàn dựa trên việc tiện ích đó có hỗ trợ các tham số giọng nói nhất định trong tệp kê khai hay không và đã đăng ký trình nghe cho onSpeak và onStop hay chưa. Nói cách khác, tiện ích không thể nhận yêu cầu lời nói và tự động quyết định xem có xử lý yêu cầu đó hay không.

Loại

AudioBuffer

Chrome 92 trở lên

Các tham số chứa vùng đệm âm thanh và dữ liệu liên quan.

Thuộc tính

audioBuffer

ArrayBuffer

Vùng đệm âm thanh từ công cụ chuyển văn bản sang lời nói. Dữ liệu này phải có độ dài chính xác là audioStreamOptions.bufferSize và được mã hoá dưới dạng đơn âm, ở audioStreamOptions.sampleRate và dưới dạng pcm tuyến tính, số thực có dấu 32 bit, tức là loại Float32Array trong javascript.
charIndex

number không bắt buộc

Chỉ mục ký tự liên kết với vùng đệm âm thanh này.
isLastBuffer

boolean không bắt buộc

Đúng nếu vùng đệm âm thanh này là vùng đệm cuối cùng cho văn bản đang được đọc.

AudioStreamOptions

Chrome 92 trở lên

Chứa định dạng luồng âm thanh mà một công cụ dự kiến sẽ tạo ra.

Thuộc tính

bufferSize

số

Số lượng mẫu trong một vùng đệm âm thanh.
sampleRate

số

Tốc độ lấy mẫu dự kiến trong vùng đệm âm thanh.

LanguageInstallStatus

Chrome 132 trở lên

Trạng thái cài đặt của một giọng nói.

Enum

"notInstalled"

"installing"

"installed"

"không thành công"

LanguageStatus

Chrome 132 trở lên

Trạng thái cài đặt của một ngôn ngữ.

Thuộc tính

error

chuỗi không bắt buộc

Thông tin chi tiết về các lỗi cài đặt. Được điền (không bắt buộc) nếu không cài đặt được ngôn ngữ.
installStatus

LanguageInstallStatus

Trạng thái cài đặt.
lang

chuỗi

Chuỗi ngôn ngữ ở dạng mã ngôn ngữ-mã vùng, trong đó vùng có thể bị bỏ qua. Ví dụ: en, en-AU, zh-CH.

LanguageUninstallOptions

Chrome 132 trở lên

Các lựa chọn để gỡ cài đặt một ngôn ngữ nhất định.

Thuộc tính

uninstallImmediately

boolean

Đúng nếu ứng dụng TTS muốn gỡ cài đặt ngôn ngữ ngay lập tức. Công cụ có thể chọn gỡ cài đặt ngôn ngữ hay không hoặc khi nào, dựa trên tham số này và thông tin của trình yêu cầu. Nếu giá trị là false, thì hệ thống có thể sử dụng các tiêu chí khác, chẳng hạn như mức sử dụng gần đây, để xác định thời điểm gỡ cài đặt.

SpeakOptions

Chrome 92 trở lên

Các tuỳ chọn được chỉ định cho phương thức tts.speak().

Thuộc tính

gender

VoiceGender không bắt buộc

Ngừng sử dụng kể từ Chrome 92

Giới tính không được dùng nữa và sẽ bị bỏ qua.
Giới tính của giọng nói cho lời nói tổng hợp.
lang

chuỗi không bắt buộc

Ngôn ngữ được dùng để tổng hợp, ở dạng ngôn ngữ-khu vực. Ví dụ: "en", "en-US", "en-GB", "zh-CN".
đề cử

number không bắt buộc

Cao độ giọng nói từ 0 đến 2, trong đó 0 là thấp nhất và 2 là cao nhất. 1.0 tương ứng với cao độ mặc định của giọng nói này.
vận tốc

number không bắt buộc

Tốc độ nói so với tốc độ mặc định của giọng nói này. 1.0 là tốc độ mặc định, thường là khoảng 180 đến 220 từ mỗi phút. 2.0 là nhanh gấp đôi và 0.5 là nhanh bằng một nửa. Giá trị này được đảm bảo nằm trong khoảng từ 0,1 đến 10,0. Khi giọng nói không hỗ trợ toàn bộ dải tốc độ này, đừng trả về lỗi. Thay vào đó, hãy cắt bớt tốc độ cho phù hợp với phạm vi mà giọng nói hỗ trợ.
voiceName

chuỗi không bắt buộc

Tên của giọng nói dùng để tổng hợp.
thể tích

number không bắt buộc

Âm lượng nói từ 0 đến 1, trong đó 0 là thấp nhất và 1 là cao nhất, với giá trị mặc định là 1.0.

TtsClient

Chrome 131 trở lên

Giá trị nhận dạng cho trạng thái yêu cầu của ứng dụng khách.

Thuộc tính

id

chuỗi

Ứng dụng khách gửi yêu cầu quản lý ngôn ngữ. Đối với tiện ích, đây là mã tiện ích duy nhất. Đối với các tính năng của Chrome, đây là tên con người có thể đọc được của tính năng.
source

TtsClientSource

Loại người yêu cầu.

TtsClientSource

Chrome 131 trở lên

Loại người yêu cầu.

Enum

"chromefeature"

"extension"

VoiceGender

Chrome 54 trở lên Không dùng nữa kể từ Chrome 70

Giới tính không được dùng nữa và sẽ bị bỏ qua.

Enum

"male"

"female"

Phương thức

updateLanguage()

Chrome 132 trở lên

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

Được một công cụ gọi khi cố gắng cài đặt ngôn ngữ và khi gỡ cài đặt ngôn ngữ. Cũng được gọi để phản hồi yêu cầu về trạng thái từ ứng dụng khách. Khi một giọng nói được cài đặt hoặc gỡ cài đặt, công cụ cũng phải gọi ttsEngine.updateVoices để đăng ký giọng nói đó.

Thông số

trạng thái

LanguageStatus

Trạng thái cài đặt của ngôn ngữ.

updateVoices()

Chrome 66 trở lên

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

Được một công cụ gọi để cập nhật danh sách giọng nói. Danh sách này ghi đè mọi giọng nói được khai báo trong tệp kê khai của tiện ích này.

Thông số

những giọng nói

TtsVoice[]

Mảng đối tượng tts.TtsVoice đại diện cho các giọng nói có sẵn để tổng hợp lời nói.

Sự kiện

onInstallLanguageRequest

Chrome 131 trở lên

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

Được kích hoạt khi ứng dụng TTS yêu cầu cài đặt một ngôn ngữ mới. Công cụ này sẽ cố gắng tải xuống và cài đặt ngôn ngữ, đồng thời gọi ttsEngine.updateLanguage kèm theo kết quả. Khi thành công, công cụ cũng sẽ gọi ttsEngine.updateVoices để đăng ký các giọng nói mới có sẵn.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(requestor: TtsClient, lang: string) => void
```
- người yêu cầu
  
  TtsClient
- lang
  
  chuỗi

onLanguageStatusRequest

Chrome 132 trở lên

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

Được kích hoạt khi ứng dụng TTS yêu cầu trạng thái cài đặt của một ngôn ngữ.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(requestor: TtsClient, lang: string) => void
```
- người yêu cầu
  
  TtsClient
- lang
  
  chuỗi

onPause

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

Không bắt buộc: nếu một công cụ hỗ trợ sự kiện tạm dừng, thì công cụ đó sẽ tạm dừng câu nói hiện tại (nếu có) cho đến khi nhận được sự kiện tiếp tục hoặc sự kiện dừng. Xin lưu ý rằng sự kiện dừng cũng sẽ xoá trạng thái tạm dừng.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
() => void
```

onResume

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

Không bắt buộc: nếu một công cụ hỗ trợ sự kiện tạm dừng, thì công cụ đó cũng phải hỗ trợ sự kiện tiếp tục để tiếp tục đọc câu nói hiện tại (nếu có). Xin lưu ý rằng sự kiện dừng cũng sẽ xoá trạng thái tạm dừng.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
() => void
```

onSpeak

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

Được gọi khi người dùng thực hiện lệnh gọi đến tts.speak() và một trong các giọng nói trong tệp kê khai của tiện ích này là giọng nói đầu tiên khớp với đối tượng tuỳ chọn.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(utterance: string, options: SpeakOptions, sendTtsEvent: function) => void
```
- câu nói
  
  chuỗi
- tùy chọn
  
  SpeakOptions
- sendTtsEvent
  
  hàm
  
  Tham số sendTtsEvent có dạng như sau:
```
(event: tts.TtsEvent) => void
```
  - sự kiện
    
    tts.TtsEvent
    
    Sự kiện từ công cụ chuyển văn bản sang lời nói cho biết trạng thái của câu nói này.

onSpeakWithAudioStream

Chrome 92 trở lên

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

Được gọi khi người dùng thực hiện lệnh gọi đến tts.speak() và một trong các giọng nói trong tệp kê khai của tiện ích này là giọng nói đầu tiên khớp với đối tượng tuỳ chọn. Khác với ttsEngine.onSpeak ở chỗ Chrome cung cấp dịch vụ phát âm thanh và xử lý việc gửi các sự kiện tts.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(utterance: string, options: SpeakOptions, audioStreamOptions: AudioStreamOptions, sendTtsAudio: function, sendError: function) => void
```
- câu nói
  
  chuỗi
- tùy chọn
  
  SpeakOptions
- audioStreamOptions
  
  AudioStreamOptions
- sendTtsAudio
  
  hàm
  
  Tham số sendTtsAudio có dạng như sau:
```
(audioBufferParams: AudioBuffer) => void
```
  - audioBufferParams
    
    AudioBuffer
    
    Các tham số chứa vùng đệm âm thanh và dữ liệu liên quan.
- sendError
  
  hàm
  
  Chrome 94 trở lên
  
  Tham số sendError có dạng như sau:
```
(errorMessage?: string) => void
```
  - errorMessage
    
    chuỗi không bắt buộc
    
    Chuỗi mô tả lỗi.

onStop

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

Được kích hoạt khi một lệnh gọi được thực hiện đến tts.stop và tiện ích này có thể đang nói. Nếu một tiện ích nhận được lệnh gọi đến onStop và lời nói đã dừng, thì tiện ích đó không cần làm gì cả (không báo lỗi). Nếu lời nói đang ở trạng thái tạm dừng, thì thao tác này sẽ huỷ trạng thái tạm dừng.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
() => void
```

onUninstallLanguageRequest

Chrome 132 trở lên

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

Được kích hoạt khi ứng dụng TTS cho biết không cần ngôn ngữ nữa.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(requestor: TtsClient, lang: string, uninstallOptions: LanguageUninstallOptions) => void
```
- người yêu cầu
  
  TtsClient
- lang
  
  chuỗi
- uninstallOptions
  
  LanguageUninstallOptions

chrome.ttsEngine Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Mô tả

Quyền

Tổng quan

Tệp kê khai

Xử lý sự kiện lời nói

Loại

AudioBuffer

Thuộc tính

AudioStreamOptions

Thuộc tính

LanguageInstallStatus

Enum

LanguageStatus

Thuộc tính

LanguageUninstallOptions

Thuộc tính

SpeakOptions

Thuộc tính

TtsClient

Thuộc tính

TtsClientSource

Enum

VoiceGender

Enum

Phương thức

updateLanguage()

Thông số

updateVoices()

Thông số

Sự kiện

onInstallLanguageRequest

Thông số

onLanguageStatusRequest

Thông số

onPause

Thông số

onResume

Thông số

onSpeak

Thông số

onSpeakWithAudioStream

Thông số

onStop

Thông số

onUninstallLanguageRequest

Thông số

chrome.ttsEngine