適用於 iTunes 的 RSS 播客摘要

在此示例中,您將學習如何使用CMS API為Apple iTunes生成RSS播客feed。

簡介

這個程序創建一個播客iTunes的RSS提要來自您的Video Cloud帳戶中的一個或多個純音頻標題。

注意:如果您輸入所有必填信息,但未生成Feed,或者其中不包含視頻,請參見故障排除下面的部分。

播客Feed生成器

原始碼

在此 GitHub 存放庫中找到與此範例相關聯的所有程式碼。

請參閱畫筆 CMS API 範例:生成iTunes的RSS播客Feed通過Brightcove學習服務( @ rcrooks1969) 上密碼筆

您需要使用此應用程序什麼:

  • 搜索中返回的所有視頻都將包含在供稿中。因此,您需要使用標籤或自定義字段來準確標識要包含的視頻。
  • 供稿中的網址必須指向MP4格式。如果您選擇的視頻沒有MP4副本,則該應用程序將將它們包括在Feed中。
  • 確保您滿意蘋果的要求關於圖像和其他東西。這個應用程式會將海報圖片用於播客圖稿。您可能需要創建一個自定義攝取資料使海報尺寸符合圖像要求。
  • 另見播客最佳做法(此應用將在輸入允許的範圍內跟踪它們)。
  • 您的播客作為純音頻內容添加到視頻雲-請參閱音頻內容有關如何執行此操作的詳細信息。
  • 播客的標題。如果沒有標題,則name視頻(或一組情節中的第一個視頻)中的。
  • 播客的描述。
  • 您的網站網址(例如https://yoursiteurl.com)
  • 該供稿的託管網址(例如https://yoursiteurl.com/feeds/podcast.rss)
  • 作者(個人或組織名稱)。
  • 播客的聯繫電子郵件地址
  • 廣播摘要(如果您忽略此內容,我們將使用description來自視頻雲)。

下面的應用程序包含您需要提供的所有信息的輸入字段。要查看該應用如何將您的數據和視頻元數據映射到播客Feed字段,請參見字段映射部分位於頁面底部。

URL標記化

除了上述要求之外,您還需要修改帳戶的URL標記。視頻雲添加了一個ttl URL的令牌表示形式,以防止您的內容被盜。默認情況下,這些令牌的壽命很短-對於播客來說太短了。您將需要聯繫Brightcove支持讓他們將令牌的生存時間值設置得更高。允許的範圍為一小時至一年。要求他們將值設置為適合您希望播客可用的時間。但請記住,這是一個帳戶設置。請勿設定這麼高的價值,以致可能會危及其他影片的安全性。

有關該應用程序工作方式的註釋

  • 填寫供稿所需的信息後,您可以從帳戶中提取(最多20個)視頻
  • 如果您為播客視頻命名,標記或具有自定義字段值以使其易於查找,則將更加容易
  • 然後,為供稿選擇一個或多個視頻
  • 如果您選擇多個視頻,則該應用會假定這些是播客片段,並且視頻的激活日期反映了片段的順序

取得認證

要使用CMS API您將需要適當的憑據。

在大多數情況下獲取憑據的最簡單方法是通過 Studio Admin API 身份驗證部分(需要您的帳戶的管理員權限)。如需詳細資訊,請參閱管理 API 驗證憑證。在大多數情況下,您可能只想獲取所有CMS API操作的權限:

CMS 應用程式介面權限
CMS 應用程式介面權限

如果您需要的權限在 Studio 中不可用,或者您希望直接從 OAuth API 獲取它們,請使用您選擇下面列出的獲取客戶端憑證文檔。無論您選擇哪一個選項,都需要要求正確的操作權限。以下內容可以與 cURL 或郵差一起使用,以獲取 CMS API 的所有權限:

        "operations": [
          "video-cloud/video/all"
        ]

使用編碼器

以下是一些有效使用上述 CodePen 的提示:

  • 按一下「結果」按鈕,切換播放器的實際顯示。
  • 按一下 HTML/CSS/JS 按鈕以顯示其中一種程式碼類型。
  • 按一下右上角的 CodePen 上的 [編輯 ],將此 CodePen 分支到您自己的帳戶。
  • 在此 GitHub 存放庫中找到與此範例相關聯的所有程式碼。

字段映射

第一個表顯示了應用程序如何將數據映射到整個播客字段。

項目字段的映射
視訊欄位 播客飼料字段
{your input} title
{your input} link
{your input} language
{your input} itunes:subtitle
{your input} itunes:image
{your input} itunes:author
{your input}(回落到author itunes:owner:name
{your input} itunes:owner:email
{your input} itunes:summary
{your input} description
current year + owner copyright
{your selection(s)} itunes:category/subcategory
{your input} itunes:explicit

第二張表顯示了此應用如何將視頻元數據映射到播客Feed 項目領域。

項目字段的映射
視訊欄位 播客飼料字段
name title
{your input} itunes:author
description itunes:subtitle
duration(轉換為HH:MM:SS格式) itunes:duration
long_description itunes:summary
images.poster.src itunes:image
MP4 source: size enclosure:length
video/mp4 enclosure:type
MP4 source:src(最佳質量的MP4再現) enclosure:url
{your input} guid
published_at(必須轉換為UTC格式) pubDate
duration(轉換成HH:MM:SS格式) itunes:duration
{your input} itunes:explicit
{your input} itunes:isClosedCaptioned
{your input} itunes:season
{your input} itunes:episode
{your input} itunes:episodeType
{your input} itunes:keywords

故障排除

如果您在使用此應用程序時遇到問題,請檢查以下事項:

  • 如果生成的提要中沒有視頻,請確保要包含的視頻具有MP4格式。您可以使用CMS API進行檢查,但是最簡單的方法是查看Studio Media模塊中的視頻文件列表,並確保至少可以下載一個演繹文件:

    可下載的轉譯
    可下載的轉譯

    如果無法下載所有格式,則需要使用包含MP4(逐行)格式的攝取配置文件替換或重新轉換視頻。

  • 如果您的視頻確實具有MP4格式,但是您的供稿中仍然不包含視頻,請檢查以確保您使用的搜索字符串返回正確的視頻。一種方法是在下面複製請求網址,替換{account_id}{search_string}使用您的帳戶ID和搜索字符串,然後在我們的網站中嘗試該請求API測試儀確保返回您期望的視頻:

            https://cms.api.brightcove.com/v1/accounts/{account_id}/videos?q={search_string}

代理代理代碼

為了建立您自己的版本此頁面上的範例應用程式,您必須建立並裝載您自己的 Proxy。(布萊特灣學習服務所使用的代理只接受來自布萊特灣域的請求。)一個示例代理,非常類似於我們使用的代理,但沒有阻止來自非 BrightCove 域的請求的檢查,可以在此 GitHub 存儲庫中找到。您還可以在那裡找到使用它的基本說明,以及在使用 REST API 中構建代理應用程序的更詳細的指南。