Étape par étape : Application vidéo TV simple utilisant Swift

Vous pouvez essayer cet exemple de deux manières :

Télécharger l'exemple

Téléchargez l'intégralité du projet Xcode pour l'expérimentation.

1. Clonez ou téléchargez le Exemples de SDK natif pour iOS à votre système local.
2. Naviguez vers le Lecteur/AppleTV/swift exemple d'application.
3. Exécutez le pod install commander.
4. Ouvrez et exécutez l'espace de travail nouvellement créé.

Pour plus de détails, consultez le Exécuter des exemples d'applications pour le SDK natif pour iOS/tvOS document.

Créez l'application en suivant les étapes de ce guide

Suivez les étapes ci-dessous pour vous familiariser avec la configuration d'un projet d'application qui utilise le Brightcove Player SDK pour tvOS. Vous pouvez afficher le code complet pour chacun des éléments suivants :

1. AppDélégué
2. ViewController

Importer le SDK natif

Bien que le Brightcove Native Player SDK pour iOS soit écrit en Obj-C, nous pouvons simplement importer les modules du framework dans notre projet Swift.

1. En dessous de l'existant import directive, ajoutez ce qui suit pour importer le Brightcove Native Player SDK :

   import BrightcovePlayerSDK

Personnalisez le projet avec vos valeurs

Ajoutez des valeurs pour accéder à votre compte Video Cloud.

1. Sous le import directives, ajoutez vos propres valeurs pour les éléments suivants :

   • Ligne 12 : Définit votre clé de politique d'API de lecture Brightcove. Cet exemple montre une vidéo renvoyée par l'API Brightcove Playback, qui est l'API la plus récente et recommandée pour récupérer du contenu de votre bibliothèque Video Cloud. Si vous n'êtes pas familiarisé avec les clés de stratégie, consultez le Présentation de l'API des règles.

   • Ligne 13 : Définit votre identifiant de compte Video Cloud

   • Ligne 14 : Définit votre ID vidéo Video Cloud

   fileprivate struct playbackConfig {
     static let policyKey = "your policy key"
     static let accountID = "your account id"
     static let videoID = "your video id"
   }

Créer une variable de vue

1. Dans le ViewController classe, ajoutez une variable pour la vue.

   class ViewController: UIViewController {
     @IBOutlet weak var videoContainerView: UIView!

Créer le service de lecture

1. Créez une variable qui définit le service de lecture Brightcove avec votre ID de compte et votre clé de stratégie. Celui-ci sera initialisé la première fois qu'il est appelé.

   Si vous débutez avec swift, consultez le guide sur Propriétés stockées paresseuses.

   lazy var playbackService: BCOVPlaybackService = {
     return BCOVPlaybackService(accountId: playbackConfig.accountID, policyKey: playbackConfig.policyKey)
   }()

Créer le contrôleur de lecture

1. Créez une variable qui définit le contrôleur de lecture Brightcove. Celui-ci sera créé la première fois qu'il est appelé.

   • Lignes 28-30 : définissez le délégué et activez les fonctions d'avance automatique et de lecture automatique.

   lazy var playbackController: BCOVPlaybackController? = {
     guard let _playbackController = BCOVPlayerSDKManager.shared().createPlaybackController() else {
       return nil
     }
     _playbackController.delegate = self
     _playbackController.isAutoAdvance = true
     _playbackController.isAutoPlay = true
   
     return _playbackController
   }()

Définir la vue du joueur

1. Créez une fonction nommée createTVPlayerView comme suit :

   • Lignes 38-39 : Définissez la vue du lecteur afin que les panneaux de la barre d'onglets puissent présenter d'autres contrôleurs de vue.
   • Lignes 42-44 : Créez la vue du lecteur et ajoutez-la à la vue du conteneur vidéo.
   • Ligne 47 : Associez la vue du lecteur au contrôleur de lecture.
   • Ligne 49 : Ajoute la vue du lecteur en tant que sous-vue de la vue principale.
   • Ligne 51 : Éteindre masque de redimensionnement automatique.

   • Lignes 52-57 : Utilisation Mise en page automatique pour définir des contraintes dynamiques pour la vue joueur.

   lazy var playerView: BCOVTVPlayerView? = {
     // Set yourself as the presenting view controller
     // so that tab bar panels can present other view controllers
     let options = BCOVTVPlayerViewOptions()
     options.presentingViewController = self
   
     // Create and add to the video container view
     guard let _playerView = BCOVTVPlayerView(options: options) else {
       return nil
     }
   
     // Link the playback controller to the Player View
     _playerView.playbackController = playbackController
   
     videoContainerView.addSubview(_playerView)
   
     _playerView.translatesAutoresizingMaskIntoConstraints = false
     NSLayoutConstraint.activate([
       _playerView.topAnchor.constraint(equalTo: videoContainerView.topAnchor),
       _playerView.rightAnchor.constraint(equalTo: videoContainerView.rightAnchor),
       _playerView.leftAnchor.constraint(equalTo: videoContainerView.leftAnchor),
       _playerView.bottomAnchor.constraint(equalTo: videoContainerView.bottomAnchor)
     ])
   
     return _playerView
   }()

Créer une fonction d'initialisation

1. Créez une initfonction comme suit :
   • Ligne 64 : Appelle l'implémentation de la super classe de la fonction init().

   • Ligne 65 : Facultatif : Envoie votre ID de compte Video Cloud à Analytics. Ceci n'est nécessaire que si vous remplacez le BCOVVideo classe ou n'utilisez pas le service ou le catalogue Brightcove Playback.

   required init?(coder aDecoder: NSCoder)
   {
     super.init(coder: aDecoder)
     playbackController?.analytics.account = playbackConfig.accountID;
   }

Traiter après le chargement de la vue

1. Dans le viewDidLoad méthode ajouter ce qui suit :

   • Ligne 72 : Appelle le requestContentFromPlaybackService fonction, que nous définirons à l'étape suivante.

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

Demander du contenu à la bibliothèque Brightcove

Afin de lire le contenu vidéo, vous demanderez une liste de lecture au service de catalogue

1. Créez une fonction nommée requestContentFromPlaybackService comme suit :

   • Lignes 75-76 : renvoie un objet vidéo à partir de l'API de lecture en fonction de l'identifiant vidéo donné.
   • Ligne 80 : ajoute la vidéo au contrôleur de lecture.
   • Ligne 82 : écrit un message d'erreur si aucune liste de lecture n'est renvoyée.

   private func requestContentFromPlaybackService() {
     playbackService.findVideo(withVideoID: playbackConfig.videoID, parameters: nil) { [weak self] (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in
   
       if let _video = video {
         //  since "isAutoPlay" is true, setVideos will begin playing the content
         self?.playbackController?.setVideos([_video] as NSArray)
       } else {
         print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
       }
     }
   }

Étendre le contrôleur de lecture

Cela permet à votre application d'écouter et de répondre aux événements de lecture vidéo.

1. Étendez le contrôleur de vue pour inclure le délégué du contrôleur de lecture Brightcove et écoutez les événements de lecture. Si vous débutez avec swift, consultez le guide sur Rallonges.

   // MARK: - BCOVPlaybackControllerDelegate
   extension ViewController: BCOVPlaybackControllerDelegate {
   
     func playbackController(_ controller: BCOVPlaybackController!, didAdvanceTo session: BCOVPlaybackSession!) {
       NSLog("ViewController Debug - Advanced to new session.")
     }
   
     func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {
       NSLog("Event: %@", lifecycleEvent.eventType)
     }
   }

Le reste

1. Créez des fonctions pour gérer les remplacements de focus pour les anciennes versions de tvOS.

   // MARK: - UIFocusEnvironment overrides
   extension ViewController {
   
     // Focus Environment override for tvOS 9
     override var preferredFocusedView: UIView? {
         return playerView
     }
   
     // Focus Environment override for tvOS 10+
     override var preferredFocusEnvironments: [UIFocusEnvironment] {
         return (playerView != nil ? [ playerView! ] : [])
     }
   }

Voir le code

Le View Controller est maintenant terminé. Voici le code complet :

//
//  ViewController.swift
//  Simple-Video-Playback
//
//  Copyright © 2018 Brightcove. All rights reserved.
//

import UIKit
import BrightcovePlayerSDK

fileprivate struct playbackConfig {
  static let policyKey = "your policy key"
  static let accountID = "your account id"
  static let videoID = "your video id"
}

class ViewController: UIViewController {
  @IBOutlet weak var videoContainerView: UIView!

  lazy var playbackService: BCOVPlaybackService = {
      return BCOVPlaybackService(accountId: playbackConfig.accountID, policyKey: playbackConfig.policyKey)
  }()

  lazy var playbackController: BCOVPlaybackController? = {
      guard let _playbackController = BCOVPlayerSDKManager.shared().createPlaybackController() else {
        return nil
      }
      _playbackController.delegate = self
      _playbackController.isAutoAdvance = true
      _playbackController.isAutoPlay = true

      return _playbackController
  }()

  lazy var playerView: BCOVTVPlayerView? = {
    // Set yourself as the presenting view controller
    // so that tab bar panels can present other view controllers
    let options = BCOVTVPlayerViewOptions()
    options.presentingViewController = self

    // Create and add to the video container view
    guard let _playerView = BCOVTVPlayerView(options: options) else {
      return nil
    }

    // Link the playback controller to the Player View
    _playerView.playbackController = playbackController

    videoContainerView.addSubview(_playerView)

    _playerView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
      _playerView.topAnchor.constraint(equalTo: videoContainerView.topAnchor),
      _playerView.rightAnchor.constraint(equalTo: videoContainerView.rightAnchor),
      _playerView.leftAnchor.constraint(equalTo: videoContainerView.leftAnchor),
      _playerView.bottomAnchor.constraint(equalTo: videoContainerView.bottomAnchor)
    ])

    return _playerView
  }()

  required init?(coder aDecoder: NSCoder)
  {
    super.init(coder: aDecoder)
    playbackController?.analytics.account = playbackConfig.accountID; // Optional
  }

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

    requestContentFromPlaybackService()
  }

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

      if let _video = video {
        //  since "isAutoPlay" is true, setVideos will begin playing the content
        self?.playbackController?.setVideos([_video] as NSArray)
      } else {
        print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
      }
    }
  }
}

// MARK: - BCOVPlaybackControllerDelegate
extension ViewController: BCOVPlaybackControllerDelegate {

  func playbackController(_ controller: BCOVPlaybackController!, didAdvanceTo session: BCOVPlaybackSession!) {
    NSLog("ViewController Debug - Advanced to new session.")
  }

  func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {
    NSLog("Event: %@", lifecycleEvent.eventType)
  }
}

// MARK: - UIFocusEnvironment overrides
extension ViewController {

  // Focus Environment override for tvOS 9
  override var preferredFocusedView: UIView? {
    return playerView
  }

  // Focus Environment override for tvOS 10+
  override var preferredFocusEnvironments: [UIFocusEnvironment] {
    return (playerView != nil ? [ playerView! ] : [])
  }
}

fileprivate struct playbackConfig {
    static let accountID = "your account id"
}

//
//  ViewController.swift
//  Simple-Video-Playback
//
//  Copyright © 2018 Brightcove. All rights reserved.
//

import UIKit
import BrightcovePlayerSDK

fileprivate struct playbackConfig {
  static let accountID = "1752604059001"
}

class ViewController: UIViewController {
  @IBOutlet weak var videoContainerView: UIView!

  lazy var playbackController: BCOVPlaybackController? = {
    guard let _playbackController = BCOVPlayerSDKManager.shared().createPlaybackController() else {
      return nil
    }
    _playbackController.delegate = self
    _playbackController.isAutoAdvance = true
    _playbackController.isAutoPlay = true

    return _playbackController
  }()

  lazy var playerView: BCOVTVPlayerView? = {
    // Set yourself as the presenting view controller
    // so that tab bar panels can present other view controllers
    let options = BCOVTVPlayerViewOptions()
    options.presentingViewController = self

    // Create and add to the video container view
    guard let _playerView = BCOVTVPlayerView(options: options) else {
      return nil
    }

    // Link the playback controller to the Player View
    _playerView.playbackController = playbackController

    videoContainerView.addSubview(_playerView)

    _playerView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
      _playerView.topAnchor.constraint(equalTo: videoContainerView.topAnchor),
      _playerView.rightAnchor.constraint(equalTo: videoContainerView.rightAnchor),
      _playerView.leftAnchor.constraint(equalTo: videoContainerView.leftAnchor),
      _playerView.bottomAnchor.constraint(equalTo: videoContainerView.bottomAnchor)
    ])

    return _playerView
  }()

  required init?(coder aDecoder: NSCoder)
  {
    super.init(coder: aDecoder)
    playbackController?.analytics.account = playbackConfig.accountID;
  }

  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://sdks.support.brightcove.com/assets/videos/hls/laughing_gull/laughing_gull.m3u8")!),
        videoWithURL(url: NSURL(string: "https://sdks.support.brightcove.com/assets/videos/hls/greatblueheron/greatblueheron.m3u8")!)]

    playbackController?.setVideos(videoArray as NSFastEnumeration);
  }

  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!
  }
}

// MARK: - BCOVPlaybackControllerDelegate
extension ViewController: BCOVPlaybackControllerDelegate {

  func playbackController(_ controller: BCOVPlaybackController!, didAdvanceTo session: BCOVPlaybackSession!) {
    NSLog("ViewController Debug - Advanced to new session.")
  }

  func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {
    NSLog("Event: %@", lifecycleEvent.eventType)
  }
}

// MARK: - UIFocusEnvironment overrides
extension ViewController {

  // Focus Environment override for tvOS 9
  override var preferredFocusedView: UIView? {
    return playerView
  }

  // Focus Environment override for tvOS 10+
  override var preferredFocusEnvironments: [UIFocusEnvironment] {
    return (playerView != nil ? [ playerView! ] : [])
  }
}