Video player SDK for iOS

You can embed a video player with Cloud Video content into your mobile app for iOS. The video player SDK for iOS will help you do this.

To use the SDK, install and configure the Xcode development environment (version 15.3 or higher) with the Swift programming language (version 5.8 or higher).

Adding a video player SDK libraryAdding a video player SDK library

Importing the librariesImporting the libraries

To import the libraries, add the following lines to your code file:

import CloudVideoPlayer
import CloudVideoPlayerUI

Using the SDKUsing the SDK

Set up the start of playbackSet up the start of playback

1. Import a library in the file:

   import CloudVideoPlayer
   

2. Create the Environment and YaPlayer objects:

   let environment = Environment(from: From(raw: "you-app-bundle"))
   
   class ViewController: UIViewController {
     let player = environment.player()
   }
   

3. Create the VideoSurface UIView component, add it to the hierarchy, and attach to the player instance:

   let surface = VideoSurface()
   
   override func loadView() {
     super.loadView()
     self.view.addSubview(surface)
     surface.frame = UIScreen.main.bounds
   }
   
   override func viewDidLoad() {
     super.viewDidLoad()
     surface.attach(player: player)
   }
   

4. Start playback:

   player.set(source: ContentId(rawValue: "https://runtime.video.cloud.yandex.net/player/..."))
   player.play()
   

Where https://runtime.video.cloud.yandex.net/player/... is a link to playable content, e.g., https://runtime.video.cloud.yandex.net/player/video/vplvmyqsxi7dlwndvb4y. For more information, see Getting an embed code or link to a video and Getting an embed code or link to a broadcast.

import CloudVideoPlayer

let environment = Environment(from: From(raw: "you-app-bundle"))

class ViewController: UIViewController {

  let player = environment.player()
  let surface = VideoSurface()

  override func loadView() {
    super.loadView()
    self.view.addSubview(surface)
    surface.frame = UIScreen.main.bounds
  }

  override func viewDidLoad() {
    super.viewDidLoad()
    surface.attach(player: player)

    player.set(source: ContentId(rawValue: "https://runtime.video.cloud.yandex.net/player/..."))
    player.play()
  }
}

Connecting a video player skinConnecting a video player skin

1. Import a library in the file:

   import CloudVideoPlayerUI
   

2. Create the VideoView UIView component, add it to the hierarchy, and connect to the player instance:

   let videoView = VideoView()
   
   override func loadView() {
     super.loadView()
     self.view.addSubview(surface)
     videoView.frame = UIScreen.main.bounds
   }
   
   override func viewDidLoad() {
     super.viewDidLoad()
     videoView.attach(player: player)
   }
   

import CloudVideoPlayerUI

let videoView = VideoView()

override func loadView() {
  super.loadView()
  self.view.addSubview(surface)
  videoView.frame = UIScreen.main.bounds
}

override func viewDidLoad() {
  super.viewDidLoad()
  videoView.attach(player: player)
}