SDK видеоплеера для iOS

С помощью SDK вы можете встроить в ваше iOS-приложение видеоплеер для воспроизведения контента из Cloud Video.

Для работы с SDK нужна среда разработки Xcode версии 16.4 или выше и Swift версии 5.8 или выше.

Подключение библиотеки SDK видеоплеераПодключение библиотеки SDK видеоплеера

Импорт библиотекИмпорт библиотек

Чтобы импортировать библиотеки, добавьте в файл с кодом следующие строки:

import CloudVideoPlayer
import CloudVideoPlayerUI

Использование SDKИспользование SDK

Настройте запуск воспроизведенияНастройте запуск воспроизведения

1. Импортируйте библиотеку в файле:

   import CloudVideoPlayer
   

2. Создайте объекты Configuration, Environment и YaPlayer:

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

3. Создайте UIView-компонент VideoSurface, добавьте его в иерархию и подключите к экземпляру плеера:

   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. Запустите воспроизведение:

   if let source = ContentIdEndpoint(url: URL(string: "https://runtime.video.cloud.yandex.net/player/...")!) {
     player.set(source: source)
     player.play()
   }
   

Где https://runtime.video.cloud.yandex.net/player/... — ссылка на видео, трансляцию или плейлист.

import CloudVideoPlayer

let environment = Environment(configuration: Configuration(from: From(raw: "your-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)

    if let source = ContentIdEndpoint(url: URL(string: "https://runtime.video.cloud.yandex.net/player/...")!) {
      player.set(source: source)
      player.play()
    }
  }
}

Подключение оболочки видеоплеераПодключение оболочки видеоплеера

1. Импортируйте библиотеку в файле:

   import CloudVideoPlayerUI
   

2. Создайте UIView-компонент VideoView, добавьте его в иерархию и подключите к экземпляру плеера:

   let videoView = VideoView()
   
   override func loadView() {
     super.loadView()
     self.view.addSubview(videoView)
     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(videoView)
  videoView.frame = UIScreen.main.bounds
}

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

Воспроизведение в SwiftUIВоспроизведение в SwiftUI

Чтобы встроить плеер в SwiftUI, оберните VideoView из CloudVideoPlayerUI в UIViewRepresentable и подключите к нему экземпляр YaPlayer, созданный через Environment.

1. Импортируйте библиотеки в файле:

   import SwiftUI
   import CloudVideoPlayer
   import CloudVideoPlayerUI
   

2. Создайте объекты Environment и YaPlayer:

   let environment = Environment(configuration: Configuration(from: From(raw: "your-app-bundle")))
   
   final class PlayerViewModel: ObservableObject {
     let player: YaPlayer = environment.player()
   
     init() {
       guard
         let url = URL(string: "https://runtime.video.cloud.yandex.net/player/..."),
         let source = ContentIdEndpoint(url: url)
       else {
         return
       }
       player.set(source: source)
       player.play()
     }
   }
   

3. Создайте тип UIViewRepresentable, который создает VideoView и вызывает attach(player:):

   struct VideoViewRepresentable: UIViewRepresentable {
     let player: YaPlayer
   
     func makeUIView(context: Context) -> VideoView {
       let view = VideoView()
       view.attach(player: player)
       return view
     }
   
     func updateUIView(_ uiView: VideoView, context: Context) {
       uiView.attach(player: player)
     }
   }
   

4. Добавьте обертку в иерархию SwiftUI:

   struct ContentView: View {
     @StateObject private var viewModel = PlayerViewModel()
   
     var body: some View {
       VideoViewRepresentable(player: viewModel.player)
         .aspectRatio(16 / 9, contentMode: .fit)
         .frame(maxHeight: .infinity, alignment: .top)
     }
   }
   

Где https://runtime.video.cloud.yandex.net/player/... — ссылка на видео, трансляцию или плейлист.

import SwiftUI
import CloudVideoPlayer
import CloudVideoPlayerUI

let environment = Environment(configuration: Configuration(from: From(raw: "your-app-bundle")))

final class PlayerViewModel: ObservableObject {
  let player: YaPlayer = environment.player()

  init() {
    guard
      let url = URL(string: "https://runtime.video.cloud.yandex.net/player/..."),
      let source = ContentIdEndpoint(url: url)
    else {
      return
    }
    player.set(source: source)
    player.play()
  }
}

struct VideoViewRepresentable: UIViewRepresentable {
  let player: YaPlayer

  func makeUIView(context: Context) -> VideoView {
    let view = VideoView()
    view.attach(player: player)
    return view
  }

  func updateUIView(_ uiView: VideoView, context: Context) {
    uiView.attach(player: player)
  }
}

struct ContentView: View {
  @StateObject private var viewModel = PlayerViewModel()

  var body: some View {
    VideoViewRepresentable(player: viewModel.player)
      .aspectRatio(16 / 9, contentMode: .fit)
      .frame(maxHeight: .infinity, alignment: .top)
  }
}

См. такжеСм. также

Справочники по библиотекам SDK:

• CloudVideoPlayer — основная библиотека с объектами Environment, YaPlayer, VideoSurface и настройками воспроизведения.
• CloudVideoPlayerUI — дополнительная библиотека интерфейсных элементов с готовой оболочкой плеера VideoView.