重要提示：此文件不適用於您目前選取的廣告格式！

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