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

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 金鑰都與代表發布商網域的封閉網域清單相關聯。只有屬於這些網域之一的網址才能透過網路播放器播放。在試用階段，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=[廣告單元代碼] 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