VideoStreamPlayback

public VideoStreamPlayback();

Создаёт базовый контейнер состояния декодера. Без переопределения контракта воспроизведения не декодирует файл.

public int MixAudio(int numFrames, ReadOnlySpan<float> buffer, int offset);

Передаёт готовые float-сэмплы в подключённый приёмник плеера. numFrames — аудиокадры, buffer — interleaved каналы, offset — индекс float-сэмпла. Нужно достаточно данных для channels × numFrames после offset. Возвращает число принятых кадров, -1 при отсутствии приёмника/ошибке границ, 0 для numFrames <= 0. Не генерирует звук из пустого массива.

public int MixAudio(int numFrames, float[] buffer = null, int offset = 0);

Передаёт готовые float-сэмплы в подключённый приёмник плеера. numFrames — аудиокадры, buffer — interleaved каналы, offset — индекс float-сэмпла. Нужно достаточно данных для channels × numFrames после offset. Возвращает число принятых кадров, -1 при отсутствии приёмника/ошибке границ, 0 для numFrames <= 0. Не генерирует звук из пустого массива.

public virtual int _GetChannels();

Возвращайте фактическое число interleaved аудиоканалов; 0 — без аудио. Согласуйте с буфером MixAudio.

public virtual double _GetLength();

Возвращайте длительность в секундах; 0 допустим при неизвестной длине. Не миллисекунды и не число кадров.

public virtual int _GetMixRate();

Возвращайте частоту декодированного аудио в Гц, например 48000. Не количество сэмплов текущего блока.

public virtual double _GetPlaybackPosition();

Возвращайте текущую позицию в секундах с согласованной временной шкалой звука и изображения.

public virtual Texture2D _GetTexture();

Возвращайте текущую Texture2D декодированного кадра. Стабильный обновляемый ресурс удобнее постоянного создания текстур; null означает отсутствие текстуры.

public virtual bool _IsPaused();

Возвращайте сохранённую паузу собственной реализации.

public virtual bool _IsPlaying();

Возвращайте фактическое состояние воспроизведения. После естественного конца установите false, чтобы VideoStreamPlayer обработал Loop/Finished. Не подменяйте паузу окончанием ролика.

public virtual void _Play();

Реализуйте запуск собственного playback. Решите и документируйте поведение повторного запуска; базовый C#-метод пуст.

public virtual void _Seek(double time);

Реализуйте перемотку к time в секундах с проверкой диапазона и восстановлением состояния декодера. Базовый метод не умеет перематывать.

public virtual void _SetAudioTrack(int idx);

Обработайте индекс звуковой дорожки согласно своему формату. Не номер аудиошины и не количество каналов.

public virtual void _SetPaused(bool paused);

Сохраните состояние паузы и приостановите продвижение декодера без потери необходимого состояния.

public virtual void _Stop();

Реализуйте остановку и очистку собственного декодера. Сброс позиции определяет ваша реализация, а не пустой базовый C#-метод.

public virtual void _Update(double delta);

Продвиньте декодер на delta секунд и обновите кадр/аудиоданные. Плеер уже применяет масштаб времени: не умножайте его повторно без причины. Не используйте число вызовов как фиксированную частоту кадров.