개요: iOS용 브라이트코브 네이티브 SDK

문서 구조

브라이트코브는 문서를 체계적이고 깔끔하며 직관적으로 유지하기 위해 노력하고 있습니다. 따라서 모든 플러그인 및 통합에 대한 자세한 내용은 github ReadME를 사용합니다. 귀하의 편의를 위해 아래에 이러한 플러그인을 나열하고 링크했습니다.

지원되는 버전

iOS용 네이티브 SDK는 다음 버전의 iOS를 지원합니다.

능동적 지원

Brightcove는 다음 iOS 버전의 최신 공개 릴리스에서 최신 iOS SDK에 대한 적극적인 지원을 제공합니다.

아이폰 OS 16
아이폰 OS 15.7
아이폰 OS 14.8
아이폰 OS 13.7

수동 지원

브라이트코브는 다음 iOS 버전에 대한 수동 지원을 제공합니다.

아이폰 OS 12.5.3
iOS 11.4.1(IMA 광고를 사용하려면 iOS 12.5.3 이상이 필요합니다.)

지원 수준 이해

지원은 [메이저 버전] 으로정의됩니다. [마이너 버전] . 운영체제의 [패치 버전] (예: iOS 12.5.3) Apple의 최신 기술 개선 사항을 활용하기 위해 다음과 같은 두 가지 수준의 지원을 제공합니다.

활성 : 브라이트코브는 이러한 OS 버전에서 버그를 테스트하고 수정합니다.
패시브 : 브라이트코브는 이러한 OS 버전에서 테스트하지만 버그 수정은 사례별로 처리됩니다.

일반적으로 브라이트코브는 사용자 기반의 80% 가 사용하는 OS 버전에 대한 적극적인 지원과 사용자 기반의 5% 이상이 사용하는 다른 버전에 대한 수동 지원을 제공합니다.

시작하기

iOS용 Native SDK로 개발을 시작하기 전에 알아두어야 할 몇 가지 개념이 있습니다.

미디어
Native SDK의 현재 버전은 Playback API를 통해 또는 인터넷 액세스 URL이 있는 원격 자산으로 Video Cloud 계정에서 콘텐츠 재생을 지원합니다.
분석
Native SDK를 통해 Video Cloud 고객은 자동으로 Video Cloud에 보고된 강력한 분석 데이터를 얻습니다.
핵심 SDK 및 종속성
CocoaPods 종속성 관리자를 사용하여 iOS용 Brightcove Native SDK 및 해당 플러그인을 프로젝트에 추가할 수 있습니다. 모든 Brightcove Native SDK 구성 요소에 대한 podspec은 BrightcoveSpecs 리포지토리 에서 호스팅됩니다.

CocoaPods 버전 1.0 이상이 필요합니다.
네이티브 SDK 참조
설치, 빠른 시작 및 아키텍처를 포함하여 Native SDK에 대해 알아보세요. 기본 비디오 플레이어 제어의 복잡성을 처리하기 위해 중요한 구성 요소가 상호 작용하는 방법을 배웁니다.

SDK의 최신 베타 버전(있는 경우)도 찾을 수 있습니다.
네이티브 SDK 개요
Brightcove Native SDK 구성 요소가 기본 iOS 구성 요소와 상호 작용하는 방법을 알아보세요.
비디오 교육
Video Cloud 라이브러리에서 비디오를 재생하는 Xcode에서 Swift 앱을 빌드하는 단계를 안내하는 일련의 교육 비디오를 봅니다.
메일링 리스트
Brightcove Native SDK 메일링 리스트에 가입하여 Native SDK에 대한 릴리스 발표 정보를 받아보세요.

채널의 게시물은 역사적 목적을 위한 것입니다. 가입하면 SDK 릴리스에 대한 이메일 목록에 추가됩니다.

SDK 다운로드

iOS용 브라이트코브 네이티브 SDK에는 두 가지 설치 패키지가 포함되어 있습니다.

다음을 지원하는 동적 프레임 워크:
- iOS 12 이상
- tvOS 12.0 이상

iOS용 브라이트코브 네이티브 SDK의 최신 버전을 다운로드하세요.

	패키지 (기투브 레포)	포드스펙	레퍼런스 설명서	참고	샘플
SDK	iOS 6.12.0용 네이티브 SDK	브라이트코베스페치	SDK 참조	릴리즈 노트	샘플 응용 프로그램

또는 다음 버튼을 선택합니다.

모든 네이티브 SDK 및 관련 플러그인에 대한 제품 업데이트를 보려면 다음을 참조하세요. Brightcove 네이티브 SDK에 대한 릴리스 정보문서.

참고:

모든 iOS 프레임워크용 Brightcove Native Player의 최소 배포 대상은 이제 iOS 12 및 tvOS 12입니다.
CocoaPods 컴플라이언스를 개선하기 위해 iOS 6.7.7용 네이티브 SDK가 일부 Podspec 파일의 이름을 변경했습니다. 자세한 내용은네이티브 SDK 레퍼런스를 참조하십시오 .
iOS 6.5.0 이상용 브라이트코브 네이티브 SDK를 사용하려면 Xcode 11.0 이상이 필요합니다.
프로젝트에서 자동 참조 계수 (ARC) 가 필요합니다. 이것은 Xcode 프로젝트의 현재 기본값입니다.
iOS 9 및 Xcode 7이 출시되면서 앱 전송 보안 (ATS) 이라는 새로운 기능이 도입되었습니다. 앱 전송 보안사용에 대해 자세히 알아보십시오 .
FairPlay 스트리밍 콘텐츠의 알려진 Apple 문제는 AirPlay 미러링 모드에서 렌더링되지 않는다는 것입니다. 자세한 내용은 WWDC 프레젠테이션을 참조하십시오. HLS에 대한 콘텐츠 보호 (성적 기록의 중간 정도 스크롤)

통합

다음 표에는 SDK 구현과 통합된 플러그인을 얻을 수 있는 링크가 포함되어 있습니다. 플러그인은 각각의 Github repos에서 다운로드 할 수 있으며 각 repo에는 플러그인 설정 방법에 대한 지침과 함께 자세한 README가 포함되어 있습니다.

샘플 응용 프로그램은 SDK와 통합된 각 플러그인의 기본 기능을 보여줍니다. 이러한 샘플 앱은 각 플러그인에 대해 알아볼 수 있는 좋은 방법이며 디버깅 시 참조점 역할을 합니다.

이전 통합 버전

범주	브라이트코브 플러그인 (Github Repo)	포드스펙	참조 문서	샘플 앱	지원되는 파트너/공급업체 플러그인
광고하는	아이엠에이 플러그인 6.12.0 ^[1]^[2]	브라이트코브 플레이어-SDK-이마	IMA 참조	구글 IMA 샘플	구글 IMA SDK 3.18.1
	FreeWheel 플러그인 6.12.0	브라이트코브 플레이어-SDK-FW	프리휠 레퍼런스	프리휠 샘플	FreeWheel 광고 관리자 6.52.0
	펄스 플러그인 6.12.0	브라이트코브 플레이어-펄스	펄스 레퍼런스	펄스 샘플	펄스 SDK 2.6.21.6.0
	SSAI 플러그인 6.12.0	브라이트코브 플레이어-SDK-FW	SSAI의 참조	SSAI의 샘플	VAST 4.1 광고 인증
분석	Omniture 플러그인 6.12.0	브라이트코브 플레이어-SDK-옴니쳐	옴니쳐 참조	옴니쳐 샘플	Adobe 비디오 하트비트 2.3.0 어도비 마케팅 클라우드 4.21.2
크롬캐스트	GoogleCast 플러그인 6.12.0	브라이트코브 플레이어-구글캐스트	구글 캐스트 참조	구글캐스트 샘플	구글 캐스트 SDK 4.6.1

다음 참고 사항은 위 표의 통합을 참조하십시오.

^[1]현재 버전의 IMA 플러그인은 iOS 버전 9.0 이상을 지원하는 구글의 IMA iOS SDK v3을 지원합니다. 자세한 내용은 Google 설명서를 참조하십시오 .

브라이트코브 네이티브 SDK는 VAST 3.0을 비롯한 VAST 프로토콜이 포함된 VMAP XML 템플릿을 지원하며 VAST 4.0에대한 제한적인 지원을제공합니다. VAST 버전 호환성에 대한 자세한 내용은 다음을 참조하세요. Google의 지원 및 호환성 문서 iOS용 IMA SDK용.

iOS용 네이티브 SDK는 IAB 오픈 측정 SDK v3.1.22를 지원합니다.

^{[2] Swift를 사용하는}경우 CocoaPods를 사용하는 대신 Google의 IMA 라이브러리를 수동으로 추가해야 합니다. 이는 Google의 IMA 라이브러리가 동적 프레임 워크를 지원하지 않기 때문에 Swift는 정적 라이브러리 빌딩을 지원하지 않기 때문입니다. 자세한 내용은수동의 섹션 iOS용 Brightcove Native SDK용 IMA 플러그인선적 서류 비치. 브라이트코브의 IMA 플러그인이 동적 프레임워크를 사용하지만 Google IMA 라이브러리는 정적 프레임워크로만 제공됩니다.

플러그인 결합

iOS용 Native SDK를 사용하면 각BCOVSessionProviders플러그인에서 생성되고 함께 연결됩니다. 그런 다음 이 체인을 사용하여 를 생성합니다BCOVPlaybackController . 자세한 내용은플러그인 섹션 결합 SDK 참조의.

IMA 플러그인을 사용한 광고

VAST 광고의 배치는 일반적으로 VMAP 문서에 의해 지정됩니다. VAST에서는 광고를 설명하고 VMAP은 동영상에 광고의 배치를 설명합니다. 코드 세부 정보는 BasicMaplayer iOS샘플을 참조하십시오.

IMA 광고를 사용하는 경우 광고를 구현하기 전에 SDK 외부에서 광고가 작동하는지 확인하는 것이 좋습니다. 다음 링크가 도움이 될 것입니다.

샘플

샘플 및 코드 조각은 다음을 참조하십시오.

다음 표에는 이전 섹션의 통합과 관련된 샘플 외에 코드 샘플에 대한 링크가 포함되어 있습니다.

샘플 애플리케이션	설명
360° 비디오	프로젝션 속성이 설정되어 있으면 360° 비디오를 재생합니다. 컨트롤 바의 Video 360 버튼을 탭하면 비디오가 VR 고글 모드로 나란히 이미지가 표시됩니다. 자세한 내용은 네이티브 SDK를 통한 360° 비디오사용문서를 참조하십시오.
기본 샘플	Video Cloud 재생 목록에서 비디오를 재생합니다.
크롬캐스트	iOS 기기에서 Google 크롬캐스트를 통해 동영상을 표시합니다.
맞춤 캡션 스타일	고유한 캡션 렌더링을 구현하여 캡션 스타일을 변경할 수 있습니다. 이 샘플은 비디오를 포함하지 않는 뷰에서 캡션을 렌더링합니다.
페어플레이가 포함된 DRM	FPS (페어플레이 스트리밍) 로 콘텐츠를 보호하세요.
DVR 라이브^[1]	HLS 라이브 스트림을 실행합니다.
네이티브 컨트롤	iOS 네이티브 플레이어 컨트롤을 사용하세요.
오프라인 재생	FairPlay 암호화로 보호되는 비디오를 포함하여 HLS 비디오를 다운로드하고 재생합니다. 개요는 네이티브 SDK를 사용한오프라인 재생문서를 참조하십시오. 개발자 세부 정보는 오프라인 재생을 위한 iOS 앱 개발자 안내서를 참조하십시오 .
플레이어 UI 사용자 지정	사용자 지정 컨트롤에 대해 여러 가지 레이아웃을 사용해 보십시오. 브라이트코브 플레이어 UI 컨트롤은 기본적으로 AirPlay 기능을제공합니다. 자체 컨트롤을 사용하여 AirPlay를 구현하려면 AirPlay용사용자 지정 컨트롤코드 스니펫을 참조하십시오.
사이드카 자막	별도의 파일에 포함된 비디오의 캡션을 표시합니다.

솔루션 가이드

다음 표에는 Brightcove Native SDK를 사용하여 자신의 앱을 시작하는 데 도움이 되고 사용 가능한 일부 기능을 안내하는 개발자 문서에 대한 링크가 포함되어 있습니다.

가이드	설명
브라이트코브 애널리틱스	Video Cloud 고객은 iOS용 브라이트코브 SDK를 사용하여 모바일 앱에서 브라이트코브 애널리틱스에서 속성을 설정하는 방법을 배우게 됩니다.
iOS용 브라이트코브 네이티브 SDK 설정	자체 백엔드 시스템의 콘텐츠를 사용하여 간단한 비디오 재생 앱을 개발하는 과정을 안내하여 iOS용 Brightcove Native SDK 작업의 기본 사항을 알아봅니다. 비디오 클라우드 고객은 추가로 브라이트코브 카탈로그 서비스에서 비디오를 검색하고 재생할 수 있습니다.
IAB 개방 측정	IMA 플러그인과 함께 Open Measurement SDK를 사용하여 광고 측정 및 검증을 위한 타사 도구를 지원하는 방법을 알아봅니다.
소스 선택	비디오를 재생할 때 기본 변환 선택 프로세스에 대해 알아봅니다.
WebVTT 캡션	iOS용 네이티브 SDK를 사용할 때 HLS 비디오용 WebVTT 캡션을 구성하는 방법을 알아봅니다.

플랫폼 노트

다음 참고 사항은 iOS 플랫폼과 관련이 있습니다.

Airplay로 화면 미러링

AirPlay 기능은 iOS용 Native SDK와 함께 기본적으로 작동하여 사용자가 Apple TV를 사용하여 고화질 디스플레이로 비디오를 스트리밍할 수 있도록 합니다.

Brightcove 컨트롤을 사용하거나 AirPlay용 사용자 지정 컨트롤을 사용할 수 있습니다. 자세한 내용은 AirPlay 코드 조각에 대한 사용자 지정 컨트롤을 참조하세요.