SDK видеоплеера для iOS
Вы можете добавить видеоплеер с контентом из Cloud Video в ваше мобильное приложение для iOS. Для этого воспользуйтесь SDK видеоплеера для iOS.
Чтобы использовать SDK, вам понадобится установленная и настроенная среда разработки Xcode
Подключение библиотеки SDK видеоплеера
-
В окне Xcode навигатора проектов (Project Navigator) выберите свой проект.
-
На верхней панели нажмите File и выберите Add Package Dependencies...
-
В строке поиска
введитеhttps://github.com/yandex-cloud/cloud-video-player-ios-sdk/
и выберите пакетcloud-video-player-ios-sdk
. -
В поле Dependency Rule выберите Up to Next Major Version и укажите версию
0.1.0-beta
. -
В поле Add to Project выберите проект, к которому вы хотите подключить библиотеки, и нажмите Add Package.
-
Во всплывающем окне укажите, к какому таргету в проекте подключить библиотеки, и нажмите Add Package.
Пакет содержит следующие библиотеки:
CloudVideoPlayer
— основная библиотека SDK видеоплеера для iOS.CloudVideoPlayerUI
— дополнительная библиотека с набором интерфейсных элементов (оболочка видеоплеера).
-
В окне Xcode навигатора проектов (Project Navigator) выберите свой проект.
-
Откройте
Package.swift
. -
Добавьте в массив
dependencies
следующую зависимость:dependencies: [ .package( url: "https://github.com/yandex-cloud/cloud-video-player-ios-sdk/", from: "0.1.0-beta" ) ],
-
Добавьте библиотеки в массив
dependencies
конкретного таргета:.target( name: "MyTargetName", dependencies: [ .product(name: "CloudVideoPlayer", package: "cloud-video-player-ios-sdk"), .product(name: "CloudVideoPlayerUI", package: "cloud-video-player-ios-sdk") ] ),
Где:
CloudVideoPlayer
— основная библиотека SDK видеоплеера для iOS.CloudVideoPlayerUI
— дополнительная библиотека с набором интерфейсных элементов (оболочка видеоплеера).
-
Сохраните изменения.
Импорт библиотек
Чтобы импортировать библиотеки, добавьте в файл с кодом следующие строки:
import CloudVideoPlayer
import CloudVideoPlayerUI
Использование SDK
Настройте запуск воспроизведения
-
Импортируйте библиотеку в файле:
import CloudVideoPlayer
-
Создайте объекты
Environment
иYaPlayer
:let environment = Environment(from: From(raw: "you-app-bundle")) class ViewController: UIViewController { let player = environment.player() }
-
Создайте 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) }
-
Запустите воспроизведение:
player.set(source: ContentId(rawValue: "https://runtime.video.cloud.yandex.net/player/...")) player.play()
Где https://runtime.video.cloud.yandex.net/player/...
— ссылка на воспроизводимый контент, например https://runtime.video.cloud.yandex.net/player/video/vplvmyqsxi7dlwndvb4y
. Подробнее см. в разделах Получить код вставки или ссылку на видео и Получить код вставки или ссылку на трансляцию.
Полный код настройки запуска воспроизведения
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()
}
}
Где https://runtime.video.cloud.yandex.net/player/...
— ссылка на воспроизводимый контент, например https://runtime.video.cloud.yandex.net/player/video/vplvmyqsxi7dlwndvb4y
. Подробнее см. в разделах Получить код вставки или ссылку на видео и Получить код вставки или ссылку на трансляцию.
Подключение оболочки видеоплеера
-
Импортируйте библиотеку в файле:
import CloudVideoPlayerUI
-
Создайте UIView-компонент
VideoView
, добавьте его в иерархию и подключите к экземпляру плеера: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)
}