Paso a paso: Aplicación de video simple usando Swift

Resumen

Este ejemplo reproduce un video devuelto por API de reproducción de Brightcove , que es la API más reciente y recomendada para recuperar contenido de su biblioteca de Video Cloud.

Para esta opción, necesitará una clave de política. Si no está familiarizado con las claves de política, consulte Descripción general de la API de políticas.

Empezar

Este ejemplo reproduce videos de una matriz interna de archivos de video.

Siga los pasos a continuación para familiarizarse con la configuración de un proyecto de aplicación que utiliza Brightcove Player SDK para iOS. Puede ver el código completo para cada uno de los siguientes:

• Delegado de aplicaciones

• Ver controlador

Crea el proyecto

Configura un proyecto en Xcode. Luego, agregue el SDK junto con las dependencias al proyecto.

Configurar el proyecto Xcode

Cree un nuevo proyecto de Xcode para la aplicación.

1. Inicie la creación de un nuevo proyecto de iOS en Xcode. Seleccione Crea un nuevo proyecto de Xcode.

   

2. Seleccione iOS y Aplicación de vista única para su nuevo proyecto. Seleccione próximo.

   

3. Configure la información del proyecto de la siguiente manera:

   • Nombre del producto: Reproducción de video simple
   • Equipo: ninguno

     El campo Equipo es opcional. Si desea distribuir su aplicación en la App Store, deberá seleccionar un equipo al que pertenezca a través del Programa de desarrolladores de Apple. Se requiere el nombre del equipo para la firma de código. En este ejemplo, seleccionaremos ninguno.

   • Nombre de la Organización: el nombre de tu compañía
   • Identificador de organización: com.example-company
     Esto hace que el nombre del producto sea único para la tienda de aplicaciones.
   • Interfaz: Guión gráfico En este ejemplo, estamos usando la interfaz del guión gráfico.
   • Idioma: Rápido

   Haz clic en Siguiente.

   

4. Elija la ubicación donde desea guardar su proyecto y créelo.

   

5. Ahora cierra el proyecto (sí, ciérrelo, ¡esto es importante!)

Agregue el SDK y sus dependencias a su proyecto

La forma más fácil de agregar el SDK y sus dependencias a su proyecto es usar CocoaPods.

CocoaPods es un administrador de dependencias que agrega bibliotecas a su proyecto. No es necesario, pero facilita la instalación. Para instalar CocoaPods, consulte las instrucciones en el CocoaPods sitio.

1. En la carpeta de su proyecto, cree un archivo de texto sin formato llamado Podfile (sin extensión de archivo).

2. Con un editor de texto, agregue las siguientes líneas de código al Podfile y guárdelo. Este código hace lo siguiente:

   • Línea 1: Apunta a la ubicación de GitHub para las especificaciones del pod CocoaPods
   • Línea 2: Apunta a la ubicación de GitHub para las especificaciones del pod de Brightcove
   • Línea 4: Define la versión de la plataforma iOS
   • Línea 6: Establece pods para usar marcos en lugar de bibliotecas estáticas

   • Líneas 8-10: Instale el SDK del reproductor nativo de Brightcove

     • Para obtener más información sobre la gestión de dependencias, consulte la Cómo administrar las dependencias con CocoaPods artículo.

   source 'https://github.com/CocoaPods/Specs.git'
   source 'https://github.com/brightcove/BrightcoveSpecs.git'
   
   platform :ios, '16.0'
   
   use_frameworks!
   
   target 'Simple-Video-Playback' do
     pod 'Brightcove-Player-Core/XCFramework'
   end

3. Abra una sesión de Terminal y navegue hasta su Reproducción de video simple Carpeta del proyecto Xcode.

   

4. En la sesión de Terminal, escriba el comando

   pod install

   y presione Regreso para ejecutarlo.

   Si CocoaPods no puede encontrar una versión compatible para el pod, o no es la última versión, intente ejecutar lo siguiente en la aplicación Terminal:

   pod update

   Debería ver una serie de mensajes en el terminal que indican que Brightcove Player SDK se ha agregado a su proyecto.

5. El pod install comando crea el .xcworkspace archivo para su proyecto.

   Observe la última línea , que es importante; a partir de este punto, debe hacer lo siguiente:

   • Abra el archivo Simple-Video-Playback.xcworkspace en Xcode
   • No use el archivo Simple-Video-Playback.xcodeproj

   

Codificar la aplicación de video

Cree el código para una aplicación de reproducción de video simple.

1. En Xcode, abra el Simple-Video-Playback.xcworkspace expediente.

Establecer el comportamiento de audio para la aplicación

La sesión de audio maneja el comportamiento del audio a nivel de la aplicación. Más información sobre el AVAudioSession clase.

Para esta muestra, usaremos el reproducción categoría. Esto reproduce audio incluso cuando la pantalla está bloqueada y con el interruptor de timbre / silencio en silencio. Ya que estamos reproduciendo video, usaremos el moviePlayback modo. Para simplificar, colocaremos este código en el Delegado de la aplicación.

1. En su proyecto, abra el archivo App Delegate (AppDelegate.swift).

2. En el didFinishLaunchingWithOptions función, agregue código para configurar la categoría de la sesión de audio. Asegúrese de importar el AVFoundation marco de referencia.

   • Necesitamos el código a continuación para asegurarnos de que el audio se reproduzca cuando lo esperamos. Por ejemplo, sin configurar este código, no escucharemos el video cuando el interruptor de silencio esté encendido.

   //
   //  AppDelegate.swift
   //  Simple-Video-Playback
   //
   //  Copyright © Brightcove. All rights reserved.
   //
   
   import UIKit
   import AVFoundation
   
   @UIApplicationMain
   class AppDelegate: UIResponder, UIApplicationDelegate {
   
     var window: UIWindow?
   
     func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
     	// Override point for customization after application launch.
   
       var categoryError :NSError?
     	var success: Bool
     	do {
     		try AVAudioSession.sharedInstance().setCategory(.playback, mode: .moviePlayback, options: .duckOthers)
     		success = true
     	} catch let error as NSError {
     		categoryError = error
     		success = false
     	}
   
     	if !success {
     		print("AppDelegate Debug - Error setting AVAudioSession category.  Because of this, there may be no sound. \(categoryError!)")
     	}
   
     	return true
     }
   
     func applicationWillResignActive(_ application: UIApplication) {
     	// Sent when the application is about to move from active to inactive state. This can occur for certain types of temporary interruptions (such as an incoming phone call or SMS message) or when the user quits the application and it begins the transition to the background state.
     	// Use this method to pause ongoing tasks, disable timers, and invalidate graphics rendering callbacks. Games should use this method to pause the game.
     }
   
     func applicationDidEnterBackground(_ application: UIApplication) {
     	// Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.
     	// If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
     }
   
     func applicationWillEnterForeground(_ application: UIApplication) {
     	// Called as part of the transition from the background to the active state; here you can undo many of the changes made on entering the background.
     }
   
     func applicationDidBecomeActive(_ application: UIApplication) {
     	// Restart any tasks that were paused (or not yet started) while the application was inactive. If the application was previously in the background, optionally refresh the user interface.
     }
   
     func applicationWillTerminate(_ application: UIApplication) {
     	// Called when the application is about to terminate. Save data if appropriate. See also applicationDidEnterBackground:.
     }
   
   }

Construya el controlador de vista

Actualice la clase View Controller para reproducir un video del servicio de catálogo de Brightcove.

1. En su proyecto, abra el archivo View Controller (ViewController.swift).

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

Conectar la vista del guión gráfico

Conecta el Main.storyboard ver con el videoContainerView propiedad.

1. En el Xcode, abra el Main.storyboard expediente.

2. En la vista complementaria, expanda el Ver escena del controlador y luego el Ver controlador menú para exponer el Vista objeto.

   

3. Haga clic en Agregar editor a la derecha y abra el ViewController.swift archivo.

   

4. Seleccione el círculo abierto junto al @IBOutlet por videoContainerView y arrástrelo al Vista objeto para conectar estos componentes.

   

Gestionar la seguridad de los medios

App Transport Security (ATS) aplica conexiones seguras entre su aplicación y los servicios web. Con el lanzamiento de Apple del SDK de iOS 9, una nueva función llamada Seguridad de transporte de aplicaciones (ATS) fue añadido.

1. Una de las siguientes situaciones se aplicará a su aplicación:

   • De forma predeterminada, Brightcove Native SDK para iOS utiliza una política de selección de fuente para elegir HTTPS sobre fuentes HTTP, por lo que puede crear sus aplicaciones con ATS habilitado.

     Eso es todo, está listo para ejecutar su aplicación.

      

   • Si sus activos remotos usan HTTPS en lugar de fuentes HTTP, entonces puede crear sus aplicaciones con ATS habilitado.

     Eso es todo, está listo para ejecutar su aplicación.

      

   • Si está utilizando fuentes HTTP o tiene otras llamadas HTTP en su aplicación, puede encontrar el siguiente mensaje de error:

     App Transport Security has blocked a cleartext HTTP (http://) resource load since it is insecure.
     Temporary exceptions can be configured via your app's Info.plist file.

     Esto significa que ATS está habilitado, pero su sistema no está configurado para cumplir con los requisitos de ATS. Para solucionar esta situación, consulte la Trabajar con App Transport Security (ATS) documento.

Ejecutar la aplicación

La aplicación está lista para compilarse y ejecutarse en un iPhone, iPad o el simulador de iOS. Debería poder reproducir los videos de su lista de reproducción.

La aplicación está lista para compilarse y ejecutarse en un iPhone, iPad o el simulador de iOS. Debería poder reproducir los videos definidos en su matriz.