Environment
Статья создана
Обновлена 8 мая 2026 г.
public struct Environment
Окружение SDK — точка входа для создания плееров и управления глобальной конфигурацией.
Contents
Discussion
Создайте один экземпляр Environment при запуске приложения. Используйте его для получения экземпляров YaPlayer.
Обновление конфигурации
Конфигурацию можно обновить в любой момент без пересоздания окружения.
Сетевые заголовки
Добавьте глобальные заголовки для всех сетевых запросов плеера.
Properties
| Name | Type | Description |
|---|---|---|
from |
From |
Идентификатор приложения из текущей конфигурации. |
Initializers
@available(*, deprecated, renamed: "init(configuration:)", message: "Use API with Configuration instead")
public init(from: From)
Создает окружение SDK.
Parameters:
from: Идентификатор приложения.
public init(configuration: Configuration)
Создает окружение SDK с заданной конфигурацией.
Parameters:
configuration: Конфигурация SDK с идентификатором приложения и опциональным провайдером информации о пользователе.
Methods
public mutating func update(configuration: Configuration)
Обновляет конфигурацию SDK без пересоздания окружения.
Parameters:
configuration: Новая конфигурация.
public func setGlobalNetworkHeaders(_ headers: [String: String])
Устанавливает HTTP-заголовки, добавляемые ко всем сетевым запросам плеера.
Parameters:
headers: Словарь заголовков в формате[имя: значение].
public func setNetworkHeaders(for contentId: ContentId, headers: [String: String])
Устанавливает HTTP-заголовки для запросов конкретного контента.
Examples
let configuration = Configuration(from: From(raw: "my-ios-app"))
let environment = Environment(configuration: configuration)
// ViewController.swift
let player = environment.player()
var newConfig = Configuration(from: From(raw: "my-ios-app"), clientInfoProvider: provider)
environment.update(configuration: newConfig)
environment.setGlobalNetworkHeaders(["Authorization": "Bearer \(token)"])