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	要朗讀的網頁標準網址。該 URL 必須可公開存取且不含任何 PII。該 URL 必須位於由 Google 設定且與特定 API 金鑰相關聯的網域上。當未提供參數時，播放器會使用目前頁面的標準網址連結標籤。這適用於朗讀目前頁面的內容，且頁面中僅嵌入單一朗讀播放器（無無限捲動）。此值會覆寫它，且發布者僅在以下情況下才需要設定它其他頁面 - 當播放器嵌入在與其內容應朗讀的頁面不同的頁面中時。在這種情況下，請將此參數設定為其他頁面的標準網址。多個播放器 - 當同一個頁面上有多個播放器時，請參閱多個播放器（無限捲動）。在這種情況下，請將此參數設定為播放器應朗讀的文章的標準網址。標準網址標籤遺失 - 當目前頁面的標準網址連結標籤遺失（且無法新增）時。在這種情況下，請將此參數設定為頁面的標準網址。
data-speakable	控制要朗讀的內容。當存在時，僅使用帶有 speakable 標記註解的元素中的文字；否則，Google 會自動分析文件以選擇合適的文字部分。
data-call-to-action-label	使用者第一次按下播放按鈕之前顯示的行動號召標籤。發布者可以使用它作為預告，邀請使用者按下播放按鈕。如果不存在，則會顯示「收聽文章」（已本地化）。字串可以是任何語言。
data-intro	MP3 音訊檔案的 URL，將在播放器開始從頭朗讀之前播放。發布者可以使用 intro 為每次播放建立獨特的開場。每當聽眾從頭開始播放時，都會播放 intro。
data-outro	MP3 音訊檔案的 URL，將在播放器結束朗讀後播放。發布者可以使用 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