아이튠즈에 대한 RSS 팟캐스트 피드

이 샘플에서는 를 사용하여 Apple iTunes용 RSS 팟캐스트 피드를 생성하는CMS API방법을 알아봅니다.

서문

이 앱은 팟캐스트를 만듭니다 iTunes용 RSS 피드 Video Cloud 계정에 있는 하나 이상의 오디오 전용 타이틀에서.

참고: 필수 정보를 모두 입력했지만 피드가 생성되지 않거나 동영상이 없는 경우 아래문제 해결섹션을 참조하세요.

팟 캐스트 피드 생성기

소스 코드

GitHub 리포지토리에서 이 샘플과 관련된 모든 코드를 찾아보세요 .

CMS API 샘플을 참조하십시오. iTunes용 RSS Podcast 피드 생성 Brightcove 학습 서비스( @rcrooks1969 ) 에코드펜 .

이 앱을 사용하기 위해 필요한 것:

  • 검색에서 반환 된 모든 비디오가 피드에 포함됩니다. 따라서 포함 할 비디오를 정확히 식별하려면 태그 또는 사용자 정의 필드를 사용해야합니다.
  • 피드의 URL 절대로 필요한 것 MP4 변환을 가리 킵니다. 선택한 비디오에 MP4 렌디션이 없는 경우 앱은 해당 비디오를 피드에포함하지 않습니다.
  • 당신이 만족하는지 확인하십시오애플의 요구 사항이미지 및 기타 사항에 대해. 이 앱은 팟 캐스트 아트 워크에 포스터 이미지를 사용합니다. 포스터 크기가 이미지 요구 사항에 맞도록 하려면 사용자 지정인제스트 프로필을만들어야 할 수 있습니다.
  • 팟캐스트 모범 사례도 참조하세요 (이 앱은 입력이 허용하는 한 해당 모범 사례를 따릅니다).
  • 팟캐스트가 비디오 클라우드에 오디오 전용 콘텐츠로 추가됩니다. 오디오 콘텐츠이 작업을 수행하는 방법에 대한 자세한 내용은
  • 팟 캐스트 제목입니다. 제목을 지정하지 않으면 동영상 (또는 에피소드 그룹의 첫 번째 동영상) 이 사용됩니다. name
  • 팟 캐스트에 대한 설명입니다.
  • 사이트 URL (예: https://yoursiteurl.com)
  • 이 피드가 호스팅될 URL (예: https://yoursiteurl.com/feeds/podcast.rss)
  • 작성자 (개인 또는 조직 이름).
  • 팟 캐스트의 연락처 이메일 주소
  • 방송 요약 정보 (이 내용을 생략하면 Video description Cloud에서 가져온 것을 사용하겠습니다).

아래 앱에는 제공해야하는 모든 정보에 대한 입력 필드가 있습니다. 앱이 데이터와 동영상 메타데이터를 팟캐스트 피드 필드에 매핑하는 방법을 보려면 페이지 하단의필드 매핑섹션을 참조하세요.

URL 토큰 화

위의 요구 사항 외에도 계정의 URL 토큰 화를 수정해야합니다. Video Cloud는 콘텐츠 도난을 방지하기 위해 렌디션용 URL에ttl토큰을 추가합니다. 기본적으로 이러한 토큰의 수명은 매우 짧습니다. 팟 캐스트에는 너무 짧습니다. 브라이트코브지원팀에문의하여 토큰 유효 기간 값을 더 높게 설정하도록 요청해야 합니다. 허용 범위는 1시간에서 1년입니다. 팟 캐스트를 사용할 수있는 시간에 적절한 값을 설정하도록 요청하십시오. 그러나 이것은 계정 설정임을 기억하십시오. 다른 동영상의 보안을 위태롭게 할 수 있도록 값을 너무 높게 설정하지 마십시오.

앱 작동 방식에 대한 참고 사항

  • 피드에 필요한 정보를 입력 한 후 계정에서 동영상 (최대 20 개)을 가져옵니다.
  • 팟 캐스트 비디오를 쉽게 찾을 수 있도록 이름을 지정하거나 태그를 지정하거나 사용자 정의 필드 값이 있으면 더 쉽습니다.
  • 그런 다음 피드에 대해 하나 이상의 비디오를 선택합니다.
  • 여러 비디오를 선택하는 경우 앱은 해당 에피소드가 팟 캐스트 에피소드이고 해당 비디오의 활성화 날짜가 에피소드 순서를 반영한다고 가정합니다.

자격 증명 가져오기

CMS API사용하려면 적절한 자격 증명이 필요합니다.

대부분의 경우 자격 증명을 얻는 가장 쉬운 방법은 Studio 관리 API 인증 섹션 (계정에 대한 관리자 권한 필요) 을 사용하는 것입니다. 보다 API 인증 자격 증명 관리자세한 내용은 대부분의 경우 모든CMS API작업에 대한 권한만 얻고 싶을 것입니다.

CMS API 사용 권한
CMS API 사용 권한

Studio에서 필요한 권한을 사용할 수 없거나 OAuth API에서 직접 권한을 가져오려면 아래 나열된 클라이언트 자격 증명가져오기문서 중 원하는 것을 선택하십시오. 어떤 옵션을 선택하든 올바른 작업 권한을 요청해야합니다. 다음은 cURL 또는 우편 배달부와 함께 CMS API에 대한 모든 권한을 얻는 데 사용할 수 있습니다.

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

코드펜 사용

위의 CodePen을 효과적으로 사용하기위한 몇 가지 팁은 다음과 같습니다.

필드 매핑

첫 번째 표는 앱이 데이터를 전체 팟 캐스트 필드에 매핑하는 방법을 보여줍니다.

항목 필드 맵핑
비디오 필드 팟캐스트 피드 필드
{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

두 번째 표는 이 앱이 동영상 메타데이터를 팟캐스트 피드항목필드에 매핑하는 방법을 보여줍니다.

항목 필드 맵핑
비디오 필드 팟캐스트 피드 필드
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 변환이 있지만 피드에 여전히 비디오가없는 경우 사용중인 검색 문자열이 올바른 비디오를 반환하는지 확인하십시오. 이를 위한 한 가지 방법은 아래의 요청 URL을 복사하고 및 를 계정 ID {account_id}{search_string}검색 문자열로 대체한 다음 API 테스터에서 요청을시도하여 예상한 동영상이 반환되는지 확인하는 것입니다.

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

프록시 코드

이 페이지에서 자신의 버전을 샘플 응용 프로그램을 빌드하려면 자신의 프록시를 만들고 호스팅해야합니다. (브라이트코브 학습 서비스에서 사용하는 프록시는 브라이트코브 도메인의 요청만 허용합니다.) 우리가 사용하는 것과 매우 유사하지만 BrightCove가 아닌 도메인의 요청을 차단하는 검사가 없는 샘플 프록시는이 GitHub 리포지토리에서 찾을 수있습니다. 또한 REST API 사용에서프록시를 사용하기 위한 기본 지침과 프록시를 중심으로 앱을 빌드하기 위한 보다 자세한 안내서를 찾을 수있습니다.