聽書（語音朗讀）

雅典娜可以把你正在看的讀給你聽。預設用你手機自帶的系統語音引擎，不用下模型、不用連網、也不花錢。只有系統引擎用不了時，才需要看下面的備選。

快速上手

1. 打開一份資料，呼出工具列，點「聽書」。

2. 可以調語速、換音色、設一個到點就停的睡眠計時。

3. EPUB 朗讀時正在讀的句子會高亮並跟著捲；PDF 只出聲，頁面上沒有句子高亮。

4. 螢幕關閉和切到背景都能繼續播。手機鎖定畫面與通知列上有播放控制項，可以暫停、上一句 / 下一句，並顯示目前的封面與章節。

如果聽不了：先做語音自檢

部分 Android 手機（尤其是改過系統底層的中國品牌機型）的語音引擎本身有問題。請到「設定 → 聽書 → 聽書自檢」，雅典娜會真正播一句測試語音，並請你確認有沒有聽到——程式自己的檢測在這些機型上並不可靠，你的耳朵才是最終判準。

自檢會按成本從低到高給出路徑：

1. 在應用內切換語音引擎。手機上裝了不止一個引擎時，換一下即可，不用下載任何東西。這個切換只在雅典娜裡生效，不動系統預設。

2. 下載缺少的語音資料。自檢可以直接把你帶到系統的語音資料安裝介面。

3. 開啟系統語音設定，檢查預設引擎與語言套件。

4. 設定雲語音（見下一節）。

5. 以上都不行時，可以在應用商店裡找一款第三方語音引擎（例如 MultiTTS）裝上作為系統引擎。雅典娜不提供下載連結，也不對第三方應用的來源與安全性負責，請自行判斷。

雲語音：用你自己的 API Key

這是一個可選的進階功能，用來補系統引擎覆蓋不到的裝置和語言。它不會被設成預設；合成失敗或斷線時自動回到系統引擎，基礎聽書始終離線可用。

雅典娜支援兩家服務商，在「設定 → 聽書 → 雲語音」裡填入自己的 API Key 即可：

- 火山引擎豆包語音：中國大陸可直接連線，不用額外搭網路。內建官方 2.0 全部音色，涵蓋 16 個語種。

- Microsoft Azure 語音服務：面向海外，音色清單用你的 Key 自動拉官方全量，涵蓋上百個語種。除 Key 之外還要填建立資源時選的區域（如 eastasia）。

關於音色與語言：兩家能提供的音色我們全部列出，按語種分組，可以直接搜。你讀什麼語言就選對應語種的音色——這和雅典娜介面支援哪些語言無關。註冊並付費之前，先到下面的官方文件確認你要的語言在不在該服務商的清單裡。 Azure 有一條必須知道：音色語種和文本語種對不上時不會出聲，但這次請求照樣計費。選錯不會報錯，只會既沒聲音又扣了錢。

關於費用：這是你和服務商之間的直接付費，雅典娜不代收、不加價、也不設限額。兩家口徑不同——Azure 官方把每個中文字元按 2 個字元計費，讀中文的實際費用是標示單價的兩倍；火山按 1 個漢字算 1 個字元。朗讀時介面會顯示本次已合成的字元數，方便你對帳。

關於安全：API Key 只保存在這台裝置上，不同步、不上傳到雅典娜的伺服器。代價是換裝置要重新填一次，好處是我們從不持有你的第三方付費憑證。已排除出系統備份與換機移轉，避免隨雲端備份外流。

常見問題

雲語音提示 resource not granted（火山）：Key 有效但服務未開通，或所選音色沒在控制台下單。請到火山控制台的開通管理裡處理。「Key 有效」和「能合成」是兩件事。

Azure 提示區域錯誤：區域必須和建立語音資源時選的完全一致。中國區（世紀互聯）的資源請填 chinaeast2 等中國區區域名。

Azure 選了音色卻完全沒聲音：多半是音色語種和這份資料的語言對不上。這種情況下 Azure 不出聲，但該次請求仍然計費，請換成一致的音色。

語速拖動沒反應：雲語音的語速由服務商介面支援，兩家都支援；若沒變化，先確認目前是不是真的在用雲語音（斷線時會靜默回到系統引擎）。

第一句要等一會兒：雲語音需要一次網路往返，之後的句子會提前預取，聽起來就連貫了。

官方文件

火山引擎豆包語音（音色清單與計費）：https://www.volcengine.com/docs/6561/1257544

Microsoft Azure 語音服務（語言與音色支援）：https://learn.microsoft.com/azure/ai-services/speech-service/language-support