AVSampleCursor

AVSampleCursor экземпляр всегда располагается в определенную выборку носителей в последовательности выборок, как определено высокоуровневой конструкцией, такой как AVAssetTrack. Это может быть перемещено в новую позицию в той последовательности или назад или вперед, или в порядке декодирования или в порядке представления. Перемещение можно требовать согласно количеству выборок или согласно дельте своевременно.

AVSampleCursor может предоставить информацию о выборке носителей в ее текущей позиции, такой как ее продолжительность, ее представление и декодировать метки времени, может ли это декодироваться независимо от других выборок носителей, его смещения и длины в его контейнере хранения, и сигнализирует ли дорожка, что выборка предназначается, чтобы быть загруженной другими непрерывными выборками носителей в «блоке».

AVSampleCursor экземпляры могут быть сравнены позицией в демонстрационной последовательности. Они могут также использоваться синхронно для выполнения I/O для загрузки данных носителей одной или более выборок носителей в память.

Наследование

NSObject
AVSampleCursor

NSObject
AVSampleCursor

Соответствует

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCopying
NSObjectProtocol
Печатаемый
NSCopying
NSObject

Оператор импорта

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

Доступный в OS X v10.10 и позже.

Пересечение выборок


    
    stepByDecodeTime (_: wasPinned:)
    - stepByDecodeTime:wasPinned:

Перемещает курсор к данному времени дельты на временной шкале декодирования.

Объявление

Swift

func stepByDecodeTime(_ deltaDecodeTime: CMTime, wasPinned outWasPinned: UnsafeMutablePointer<ObjCBool>) -> CMTime

Objective C

- (CMTime)stepByDecodeTime:(CMTime)deltaDecodeTime wasPinned:(BOOL *)outWasPinned

Параметры


      deltaDecodeTime

Количество времени для перемещения во временную шкалу декодирования.


      outWasPinned

Если начало или конец демонстрационной последовательности были достигнуты перед требуемым deltaDecodeTime был пересечен, булево значение в адресе, указанном outWasPinned установлен в YEStrue. Может быть NULL если не желаема эта информация.

Возвращаемое значение

Количество времени курсор было перемещено вдоль временной шкалы декодирования. Поскольку демонстрационная защелка курсоров к демонстрационным границам, когда продвинуто, это значение может не быть равно deltaDecodeTime даже если не был прикреплен курсор.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

– stepByPresentationTime:wasPinned:
– stepInDecodeOrderByCount:
– stepInPresentationOrderByCount:


    
    stepByPresentationTime (_: wasPinned:)
    - stepByPresentationTime:wasPinned:

Перемещает курсор к данному времени дельты на временной шкале представления.

Объявление

Swift

func stepByPresentationTime(_ deltaPresentationTime: CMTime, wasPinned outWasPinned: UnsafeMutablePointer<ObjCBool>) -> CMTime

Objective C

- (CMTime)stepByPresentationTime:(CMTime)deltaPresentationTime wasPinned:(BOOL *)outWasPinned

Параметры


      deltaPresentationTime

Количество времени для перемещения во временную шкалу представления.


      outWasPinned

Количество времени курсор было перемещено вдоль временной шкалы представления. Поскольку демонстрационная защелка курсоров к демонстрационным границам, когда продвинуто, это значение может не быть равно deltaDecodeTime даже если не был прикреплен курсор.

Возвращаемое значение

Количество времени курсор было перемещено вдоль временной шкалы представления. Даже если курсор не был прикреплен, поскольку демонстрационная защелка курсоров к демонстрационным границам, когда продвинуто, это значение может не быть равно deltaPresentationTime.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

– stepByDecodeTime:wasPinned:
– stepInDecodeOrderByCount:
– stepInPresentationOrderByCount:


    
    stepInDecodeOrderByCount (_:)
    - stepInDecodeOrderByCount:

Перемещает курсор, поданное число выборок декодирует порядок.

Объявление

Swift

func stepInDecodeOrderByCount(_ stepCount: Int64) -> Int64

Objective C

- (int64_t)stepInDecodeOrderByCount:(int64_t)stepCount

Параметры


      stepCount

Число выборок для преодолевания. Если положительный, шаг передают этому много выборок. Если отрицательный, продвиньтесь назад это много выборок.

Возвращаемое значение

Число выборок курсор пересечено. Если начало или конец демонстрационной последовательности были достигнуты, прежде чем требуемое число выборок было пересечено, абсолютное значение результата будет меньше, чем абсолютное значение stepCount.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

– stepByDecodeTime:wasPinned:
– stepByPresentationTime:wasPinned:
– stepInPresentationOrderByCount:


    
    stepInPresentationOrderByCount (_:)
    - stepInPresentationOrderByCount:

Перемещает курсор данное число выборок в порядке представления.

Объявление

Swift

func stepInPresentationOrderByCount(_ stepCount: Int64) -> Int64

Objective C

- (int64_t)stepInPresentationOrderByCount:(int64_t)stepCount

Параметры


      stepCount

Возвращаемое значение

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

– stepByDecodeTime:wasPinned:
– stepByPresentationTime:wasPinned:
– stepInDecodeOrderByCount:

Получение выборок


    
    samplesWithEarlierDecodeTimeStampsMayHaveLaterPresentationTimeStampsThanCursor (_:)
    - samplesWithEarlierDecodeTimeStampsMayHaveLaterPresentationTimeStampsThanCursor:

Тестирует границу в переупорядочении от порядка декодирования до порядка представления, определяя, возможно ли это для какой-либо выборки ранее в порядке декодирования, чем выборка в позиции получателя может иметь метку времени представления позже, чем тот из указанного демонстрационного курсора.

Объявление

Swift

func samplesWithEarlierDecodeTimeStampsMayHaveLaterPresentationTimeStampsThanCursor(_ cursor: AVSampleCursor!) -> Bool

Objective C

- (BOOL)samplesWithEarlierDecodeTimeStampsMayHaveLaterPresentationTimeStampsThanCursor:(AVSampleCursor *)cursor

Параметры


      cursor

Экземпляр AVSampleCursor с которым можно протестировать демонстрационную границу переупорядочения.

Возвращаемое значение

YEStrue если это возможно для какой-либо выборки ранее в порядке декодирования, чем выборка в позиции получателя может иметь метку времени представления позже, чем тот из указанного демонстрационного курсора; иначе, NOfalse.

Обсуждение

Если получатель и ссылка курсора различные последовательности выборок, как тогда, когда они создаются различными экземплярами AVAssetTrack, результаты не определены.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.


    
    samplesWithLaterDecodeTimeStampsMayHaveEarlierPresentationTimeStampsThanCursor (_:)
    - samplesWithLaterDecodeTimeStampsMayHaveEarlierPresentationTimeStampsThanCursor:

Тестирует границу в переупорядочении от порядка декодирования до порядка представления, определяя, возможно ли это для какой-либо выборки позже в порядке декодирования, чем выборка в позиции получателя может иметь метку времени представления ранее, чем тот из указанного демонстрационного курсора.

Объявление

Swift

func samplesWithLaterDecodeTimeStampsMayHaveEarlierPresentationTimeStampsThanCursor(_ cursor: AVSampleCursor!) -> Bool

Objective C

- (BOOL)samplesWithLaterDecodeTimeStampsMayHaveEarlierPresentationTimeStampsThanCursor:(AVSampleCursor *)cursor

Параметры


      cursor

Экземпляр AVSampleCursor с которым можно протестировать демонстрационную границу переупорядочения.

Возвращаемое значение

YEStrue если это возможно для какой-либо выборки позже в порядке декодирования, чем выборка в позиции получателя может иметь метку времени представления ранее, чем тот из указанного демонстрационного курсора; иначе, NOfalse.

Обсуждение

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

Получение меток времени

decodeTimeStamp decodeTimeStamp Свойство

Метка времени декодирования (DTS) выборки в текущей позиции курсора. (только для чтения)

Объявление

Swift

var decodeTimeStamp: CMTime { get }

Objective C

@property(nonatomic, readonly) CMTime decodeTimeStamp

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
presentationTimeStamp presentationTimeStamp Свойство

Метка времени представления (PTS) выборки в текущей позиции курсора. (только для чтения)

Объявление

Swift

var presentationTimeStamp: CMTime { get }

Objective C

@property(nonatomic, readonly) CMTime presentationTimeStamp

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

Сравнение демонстрационных курсоров

comparePositionInDecodeOrderWithPositionOfCursor (_:) - comparePositionInDecodeOrderWithPositionOfCursor:

Сравнивает относительные позиции два AVSampleCursors.

Объявление

Swift

func comparePositionInDecodeOrderWithPositionOfCursor(_ cursor: AVSampleCursor!) -> NSComparisonResult

Objective C

- (NSComparisonResult)comparePositionInDecodeOrderWithPositionOfCursor:(AVSampleCursor *)cursor

Параметры

cursor

Экземпляр AVSampleCursor с которым можно сравнить позиции.

Возвращаемое значение

Возвраты kCFCompareLessThan, kCFCompareEqualTo или kCFCompareGreaterThanВ зависимости от того, указывает ли получатель на выборку прежде, то же как, или после выборки, на которую указывают cursor.

Обсуждение

Если получатель и ссылка курсора различные последовательности выборок, как тогда, когда они создаются различными экземплярами AVAssetTrack, результаты не определены.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

Получение текущей демонстрационной информации

currentChunkInfo currentChunkInfo Свойство

Предоставляет информацию о «блоке» выборок, которым принадлежит текущая выборка. (только для чтения)

Объявление

Swift

var currentChunkInfo: AVSampleCursorChunkInfo { get }

Objective C

@property(nonatomic, readonly) AVSampleCursorChunkInfo currentChunkInfo

Обсуждение

Если формат носителя, определяющий последовательность выборок, не будет сигнализировать «разделение на блоки» выборок всегда, то каждую выборку рассмотрит получатель как принадлежащий блоку одной выборки только.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
currentChunkStorageRange currentChunkStorageRange Свойство

Смещение и продолжительность выборок в currentChunkStorageURL, предназначающихся, чтобы быть загруженными вместе с текущей выборкой как «блок». (только для чтения)

Объявление

Swift

var currentChunkStorageRange: AVSampleCursorStorageRange { get }

Objective C

@property(nonatomic, readonly) AVSampleCursorStorageRange currentChunkStorageRange

Обсуждение

Если текущий блок не сохранен непрерывно в его контейнере хранения, currentChunkStorageRange.offset будет -1. В таком использовании случаев AVSampleBufferGenerator получить демонстрационные данные.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
currentChunkStorageURL currentChunkStorageURL Свойство

URL контейнера хранения текущей выборки, а также других выборок, предназначающихся, чтобы быть загруженными в той же работе как «блок». (только для чтения)

Объявление

Swift

var currentChunkStorageURL: NSURL! { get }

Objective C

@property(nonatomic, readonly) NSURL *currentChunkStorageURL

Обсуждение

Если nil, местом хранения блока является URL актива дорожки демонстрационного курсора, если это имеет тот.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
currentSampleDependencyInfo currentSampleDependencyInfo Свойство

Предоставляет информацию о зависимостях между выборкой носителей и другими выборками носителей в той же демонстрационной последовательности, если известный. (только для чтения)

Объявление

Swift

var currentSampleDependencyInfo: AVSampleCursorDependencyInfo { get }

Objective C

@property(nonatomic, readonly) AVSampleCursorDependencyInfo currentSampleDependencyInfo

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
currentSampleDuration currentSampleDuration Свойство

Продолжительность представления выборки в текущей позиции получателя. (только для чтения)

Объявление

Swift

var currentSampleDuration: CMTime { get }

Objective C

@property(nonatomic, readonly) CMTime currentSampleDuration

Обсуждение

Если получатель должен быть усовершенствован мимо его текущей позиции для определения продолжительности представления текущей выборки, значения currentSampleDuration равно kCMTimeIndefinite. Это может произойти с форматами потоковой передачи, такими как транспортные потоки MPEG 2.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
currentSampleIndexInChunk currentSampleIndexInChunk Свойство

Индекс текущей выборки в блоке, которому это принадлежит. (только для чтения)

Объявление

Swift

var currentSampleIndexInChunk: Int64 { get }

Objective C

@property(nonatomic, readonly) int64_t currentSampleIndexInChunk

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
currentSampleStorageRange currentSampleStorageRange Свойство

Смещение и продолжительность текущей выборки в currentChunkStorageURL. (только для чтения)

Объявление

Swift

var currentSampleStorageRange: AVSampleCursorStorageRange { get }

Objective C

@property(nonatomic, readonly) AVSampleCursorStorageRange currentSampleStorageRange

Обсуждение

Если текущая выборка не сохранена непрерывно в ее контейнере хранения, currentSampleStorageRange.offset будет -1. В таких случаях можно использовать AVSampleBufferGenerator получить демонстрационные данные.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
currentSampleSyncInfo currentSampleSyncInfo Свойство

Предоставляет информацию о текущей выборке для рассмотрения при ресинхронизации декодера, вычищая. (только для чтения)

Объявление

Swift

var currentSampleSyncInfo: AVSampleCursorSyncInfo { get }

Objective C

@property(nonatomic, readonly) AVSampleCursorSyncInfo currentSampleSyncInfo

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
copyCurrentSampleFormatDescription () - copyCurrentSampleFormatDescription

Возвращает описание формата выборки в текущей позиции получателя.

Объявление

Swift

func copyCurrentSampleFormatDescription() -> CMFormatDescription!

Objective C

- (CMFormatDescriptionRef)copyCurrentSampleFormatDescription

Возвращаемое значение

Описание формата выборки в текущей позиции получателя.

Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.