重要事項：本文件不適用於您目前選取的格式 email！

amp-google-read-aloud-player

說明

嵌入 Google 文字轉語音播放器。

必要腳本

<script async custom-element="amp-google-read-aloud-player" src="https://cdn.ampproject.org/v0/amp-google-read-aloud-player-0.1.js"></script>

支援版面配置

fixed fixed-height

行為

嵌入 Google 文字轉語音播放器。此播放器會朗讀您網頁的內容。

屬性

data-api-key (必填)	API 金鑰用於識別發布商，且必須提供才能使用播放器。每個 API 金鑰都與代表發布商網域的封閉網域清單相關聯。只有屬於這些網域之一的 URL 才能透過網頁播放器播放。在試用階段，API 金鑰將由 Google 提供給發布商。使用 Google Cloud Console 產生的其他 API 金鑰將無法運作。
data-tracking-ids (必填)	用於傳送播放器指標的 Google Analytics 追蹤 ID 清單 (以逗號分隔)。您必須擁有 Google Analytics 追蹤 ID，才能在試用期間使用此播放器。追蹤 ID 將由 Google 提供給您。如果您也想將播放器指標傳送至您的 Google Analytics 帳戶，請將您的追蹤 ID (或 ID) 新增至此清單。
data-voice (必填)	用於產生文字轉語音音訊的聲音。發布商應僅使用單一聲音，且僅從支援的聲音清單 (待定) 中選取。
data-url	要朗讀的網頁標準網址。網址必須可公開存取且不含任何 PII。網址必須位於由 Google 設定且與特定 API 金鑰相關聯的網域上。如果未提供參數，播放器會使用目前頁面的標準網址連結標籤。這對於朗讀目前頁面的內容且頁面中只嵌入單一文字轉語音播放器 (無無限捲動) 的情況很有用。此值會覆寫它，發布商僅需在下列情況中設定此值其他頁面 - 當播放器嵌入在與要朗讀其內容的頁面不同的頁面中時。在這種情況下，請將此參數設定為其他頁面的標準網址。多個播放器 - 當同一個頁面上有多個播放器時，請參閱多個播放器 (無限捲動)。在這種情況下，請將此參數設定為播放器應朗讀的文章的標準網址。缺少標準網址標籤 - 當目前頁面的標準網址連結標籤遺失 (且無法新增) 時。在這種情況下，請將此參數設定為頁面的標準網址。
data-speakable	控制要朗讀的內容。如果存在，則僅使用以 speakable 標記註解的元素中的文字，否則 Google 會自動分析文件以選擇合適的文字部分。
data-call-to-action-label	首次使用者按下播放按鈕前顯示的行動號召標籤。發布商可以使用它作為預告，邀請使用者按下播放按鈕。如果未提供，則會顯示「聆聽文章」(已在地化)。字串可以使用任何語言。
data-intro	MP3 音訊檔的網址，該檔案將在播放器開始從頭朗讀之前播放。發布商可以使用 intro 為每次播放建立獨特的開場。每當聽眾從頭開始播放時，就會播放 intro。
data-outro	MP3 音訊檔的網址，該檔案將在播放器結束朗讀後播放。發布商可以使用 outro 為每次播放建立獨特的結尾。
data-ad-tag-url	完整的 VAST 廣告代碼網址，其中包含用於播放前置音訊廣告的參數。如果存在，則在使用者首次點擊播放按鈕後，將在朗讀網頁內容之前播放音訊廣告。如果不存在，則僅播放網頁內容。廣告代碼網址必須包含下列參數 iu=[Ad unit code] sz=1x1 ad_type=audio output=vast unviewed_position_start=1 env=instream vad_type=linear

用法

在您的 AMP 文件中加入 amp-google-read-aloud-player

<amp-google-read-aloud-player
  height="65"
  data-api-key="<YOUR_API_KEY>"
  data-tracking-ids="<YOUR_TRACKING_IDS>"
  data-voice="<YOUR_VOICE>"
></amp-google-read-aloud-player>

驗證

請參閱 AMP 驗證器規格中的 amp-google-read-aloud-player 規則。

需要更多協助嗎？

您已閱讀本文件數十次，但它仍然沒有涵蓋您所有的問題？也許其他人也有相同的感受：在 Stack Overflow 上與他們聯繫。

前往 Stack Overflow

發現錯誤或缺少功能？

AMP 專案強烈鼓勵您的參與和貢獻！我們希望您能成為我們開放原始碼社群的持續參與者，但我們也歡迎您針對您特別熱衷的問題做出一次性貢獻。

前往 GitHub