단계별: 스위프트를 사용하는 간단한 비디오 앱

이 샘플을 시험해보는 방법에는 두 가지가 있습니다.

샘플 다운로드

실험을 위해 전체 Xcode 프로젝트를 다운로드하십시오.

1. iOS용 Native SDK 샘플을로컬 시스템에 복제하거나 다운로드합니다.
2. 플레이어/비디오클라우드베이직플레이어/Swift샘플 앱으로 이동합니다.
3. pod install명령을 실행합니다.
4. 새로 만든 작업공간을 열고 실행합니다.

자세한 내용은 iOS/tvOS용 네이티브 SDK용 샘플 앱실행문서를 참조하십시오.

이 가이드의 단계에 따라 앱 빌드

다음 단계에 따라 tvOS용 브라이트코브 플레이어 SDK를 사용하는 앱 프로젝트를 설정하는 방법을 익힐 수 있습니다. 다음 각 항목에 대한 전체 코드를 볼 수 있습니다.

1. 앱델리게이트

2. 뷰 컨트롤러

네이티브 SDK 가져오기

iOS용 브라이트코브 네이티브 플레이어 SDK는 Objective-C로 작성되었지만 프레임워크 모듈을 Swift 프로젝트로 간단히 가져올 수 있습니다.

1. 기존import디렉티브 아래에 다음을 추가하여 브라이트코브 네이티브 플레이어 SDK를 임포트하십시오.

   import BrightcovePlayerSDK

가치로 프로젝트를 사용자 정의하십시오.

값을 추가하여 Video Cloud 계정에 액세스합니다.

이 예는 Brightcove 재생 API , Video Cloud 라이브러리에서 콘텐츠를 검색하기 위한 최신 권장 API입니다. 정책 키에 익숙하지 않은 경우정책 API 개요를 참조하십시오 .

1. import지시문 아래에 다음과 같은 값을 직접 추가하십시오.

   • 라인 12: Brightcove Playback API 정책 키를 정의합니다.
   • 13호선: 비디오 클라우드 계정 ID를 정의합니다.

   • 라인 14: 비디오 클라우드 비디오 ID 정의

   // ** Customize these values with your own account information **
   let kViewControllerPlaybackServicePolicyKey = "your policy key"
   let kViewControllerAccountID = "your account id"
   let kViewControllerVideoID = "your video id"

클래스 대리자 설정

이렇게 하면 앱이 비디오 재생 이벤트 및 플레이어 제어 이벤트를 듣고 응답할 수 있습니다.

1. 다음과 같이 뷰 컨트롤러 클래스를 업데이트하십시오.

   class ViewController: UIViewController, BCOVPlaybackControllerDelegate {
   

상수를 선언하고보기 설정

1. ViewController수업에 다음을 추가합니다.

   • 지하철 16호선 공유 관리자를 초기화합니다. BCOVPlayerSDKManager클래스는 SDK 에코시스템에서 다른 객체를 만들 수 있는 싱글톤입니다.
   • 17번째 줄: 계정 ID 및 정책 키로 Brightcove 재생 서비스를 초기화하는 상수를 정의합니다. BCOVPlaybackService클래스는 Playback API에서 데이터를 검색하기 위한 비동기 메서드를 제공합니다.
   • 18호선: 재생 제어기의 상수를 정의합니다. BCOVPlaybackController에는 재생 기능을 제어하는 메서드가 있습니다.

   • 19번째 줄: 뷰에 대한 변수를 정의합니다.

   class ViewController: UIViewController, BCOVPlaybackControllerDelegate {
     let sharedSDKManager = BCOVPlayerSDKManager.shared()
     let playbackService = BCOVPlaybackService(accountId: kViewControllerAccountID, policyKey: kViewControllerPlaybackServicePolicyKey)
     let playbackController :BCOVPlaybackController
     @IBOutlet weak var videoContainerView: UIView!

초기화 함수 만들기

1. 이전 단계의 코드 아래에서 다음과 같이init()함수를 생성합니다.
   • 23번째 줄: 공유 관리자를 사용하여 재생 제어기를 만듭니다.

   • 제27호선: 선택 사항: 비디오 클라우드 계정 ID를 분석에 보냅니다. 이는BCOVVideo클래스를 오버라이드하거나 Brightcove Playback 서비스 또는 카탈로그를 사용하지 않는 경우에만 필요합니다.

   • 29~31행: 델리게이트를 설정하고 자동 진행 및 자동 재생 기능을 켜십시오.

    required init?(coder aDecoder: NSCoder) {
   	playbackController = (sharedSDKManager?.createPlaybackController())!
   
   	super.init(coder: aDecoder)
   
   	playbackController.analytics.account = kViewControllerAccountID // Optional
   
   	playbackController.delegate = self
   	playbackController.isAutoAdvance = true
   	playbackController.isAutoPlay = true
   }

플레이어 구성

1. viewDidLoad()함수에 다음을 추가합니다.

   • 39호선: 표준 VOD 레이아웃을 사용하여 브라이트코브 플레이어 컨트롤을 만들고 설정합니다.
   • 라인 44: 플레이어 뷰를 기본 뷰의 하위 뷰로 추가합니다.
   • 45호선: 자동 크기 조정 마스크를 끕니다 .
   • 라인 46-51호선: 자동 레이아웃을사용하여 플레이어 뷰의 동적 제약 조건을 정의할 수 있습니다.
   • 54번째 줄: 플레이어 뷰를 재생 컨트롤러와 연결합니다.

   • 라인 56: requestContentFromPlaybackService함수를 호출합니다. 이 함수는 다음 단계에서 정의합니다.

   override func viewDidLoad() {
     super.viewDidLoad()
     // Do any additional setup after loading the view, typically from a nib.
   
     // Set up our player view. Create with a standard VOD layout.
     guard let playerView = BCOVPUIPlayerView(playbackController: self.playbackController, options: nil, controlsView: BCOVPUIBasicControlView.withVODLayout()) else {
         return
     }
   
     // Install in the container view and match its size.
     self.videoContainerView.addSubview(playerView)
     playerView.translatesAutoresizingMaskIntoConstraints = false
     NSLayoutConstraint.activate([
         playerView.topAnchor.constraint(equalTo: self.videoContainerView.topAnchor),
         playerView.rightAnchor.constraint(equalTo: self.videoContainerView.rightAnchor),
         playerView.leftAnchor.constraint(equalTo: self.videoContainerView.leftAnchor),
         playerView.bottomAnchor.constraint(equalTo: self.videoContainerView.bottomAnchor)
     ])
   
     // Associate the playerView with the playback controller.
     playerView.playbackController = playbackController
   
     requestContentFromPlaybackService()
   }

브라이트코브 라이브러리에서 콘텐츠 요청

비디오 콘텐츠를 재생하려면 카탈로그 서비스에서 재생 목록을 요청합니다.

1. viewDidLoad()함수 아래에 다음과requestContentFromPlaybackService()같은 이름의 함수를 생성합니다.

   • 60호선: 주어진 동영상 ID를 기반으로 Playback API에서 동영상 개체를 반환합니다.
   • 지하철 63호선 재생 컨트롤러에 비디오를 추가합니다.

   • 라인 65: 재생 목록이 반환되지 않으면 오류 메시지를 작성합니다.

   func requestContentFromPlaybackService() {
     playbackService?.findVideo(withVideoID: kViewControllerVideoID, parameters: nil) { (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in
   
       if let v = video {
           self.playbackController.setVideos([v] as NSArray)
       } else {
           print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
       }
     }
   }

코드 보기

이제 뷰 컨트롤러가 완료되었습니다. 다음은 전체 코드입니다.

//
//  ViewController.swift
//  VideoCloudBasicPlayer
//
//  Copyright © Brightcove, Inc. All rights reserved.
//

import UIKit
import BrightcovePlayerSDK

let kViewControllerPlaybackServicePolicyKey = "your policy key"
let kViewControllerAccountID = "your account id"
let kViewControllerVideoID = "your video id"

class ViewController: UIViewController, BCOVPlaybackControllerDelegate {

  let sharedSDKManager = BCOVPlayerSDKManager.shared()
  let playbackService = BCOVPlaybackService(accountId: kViewControllerAccountID, policyKey: kViewControllerPlaybackServicePolicyKey)
  let playbackController :BCOVPlaybackController
  @IBOutlet weak var videoContainerView: UIView!

  required init?(coder aDecoder: NSCoder) {
    playbackController = (sharedSDKManager?.createPlaybackController())!

    super.init(coder: aDecoder)

    playbackController.analytics.account = kViewControllerAccountID // Optional

    playbackController.delegate = self
    playbackController.isAutoAdvance = true
    playbackController.isAutoPlay = true
  }

  override func viewDidLoad() {
    super.viewDidLoad()
    // Do any additional setup after loading the view, typically from a nib.

    // Set up our player view. Create with a standard VOD layout.
    guard let playerView = BCOVPUIPlayerView(playbackController: self.playbackController, options: nil, controlsView: BCOVPUIBasicControlView.withVODLayout()) else {
        return
    }

    // Install in the container view and match its size.
    self.videoContainerView.addSubview(playerView)
    playerView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
      playerView.topAnchor.constraint(equalTo: self.videoContainerView.topAnchor),
      playerView.rightAnchor.constraint(equalTo: self.videoContainerView.rightAnchor),
      playerView.leftAnchor.constraint(equalTo: self.videoContainerView.leftAnchor),
      playerView.bottomAnchor.constraint(equalTo: self.videoContainerView.bottomAnchor)
    ])

    // Associate the playerView with the playback controller.
    playerView.playbackController = playbackController

    requestContentFromPlaybackService()
  }

  func requestContentFromPlaybackService() {
    playbackService?.findVideo(withVideoID: kViewControllerVideoID, parameters: nil) { (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in

      if let v = video {
        self.playbackController.setVideos([v] as NSArray)
      } else {
        print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
      }
    }
  }
}

//
//  ViewController.swift
//  Simple-Video-Playback for Brightcove Player Customers
//
//  Copyright © Brightcove. All rights reserved.
//

import UIKit
import BrightcovePlayerSDK

let kViewControllerAccountID = "your account id" // For Brightcove registration

class ViewController: UIViewController, BCOVPlaybackControllerDelegate {
    let sharedSDKManager = BCOVPlayerSDKManager.shared()
    let playbackController :BCOVPlaybackController
    @IBOutlet weak var videoContainerView: UIView!

    required init?(coder aDecoder: NSCoder) {
        // Create the Brightcove playback controller
        playbackController = (sharedSDKManager?.createPlaybackController())!

        super.init(coder: aDecoder)

        // Register your app with Brightcove
        playbackController.analytics.account = kViewControllerAccountID

        // Configure the player
        playbackController.delegate = self
        playbackController.isAutoAdvance = true
        playbackController.isAutoPlay = true
    }

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view, typically from a nib.

        // Create an array of videos
        var videoArray = [AnyObject]()
        videoArray = [videoWithURL(url: NSURL(string: "https://solutions.brightcove.com/bcls/assets/videos/Great_Horned_Owl.mp4")!),
                      videoWithURL(url: NSURL(string: "https://solutions.brightcove.com/bcls/assets/videos/Great_Blue_Heron.mp4")!)]

        // Set up the player view with a standard VOD layout.
        guard let playerView = BCOVPUIPlayerView(playbackController: self.playbackController, options: nil, controlsView: BCOVPUIBasicControlView.withVODLayout()) else {
            return
        }

        // Install in the container view and match its size.
        self.videoContainerView.addSubview(playerView)
        playerView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            playerView.topAnchor.constraint(equalTo: self.videoContainerView.topAnchor),
            playerView.rightAnchor.constraint(equalTo: self.videoContainerView.rightAnchor),
            playerView.leftAnchor.constraint(equalTo: self.videoContainerView.leftAnchor),
            playerView.bottomAnchor.constraint(equalTo: self.videoContainerView.bottomAnchor)
        ])

        // Associate the playerView with the playback controller.
        playerView.playbackController = playbackController

        // Load the video array into the player and start video playback
        playbackController.setVideos(videoArray as NSArray)
        playbackController.play();
    }

    func videoWithURL(url: NSURL) -> BCOVVideo {
      // Set the delivery method for BCOVSources that belong to a video
      let source:BCOVSource = BCOVSource(url: url as URL, deliveryMethod: kBCOVSourceDeliveryHLS, properties: nil)
      let video = BCOVVideo.init(source: source, cuePoints: BCOVCuePointCollection.init(array: []), properties: [NSObject:AnyObject]())
      return video!
    }
}

응용 프로그램은 아이폰, 아이 패드 또는 iOS 시뮬레이터에서 구축하고 실행할 준비가되어 있습니다. 재생 목록에서 비디오를 재생할 수 있어야합니다.