AVAsset AVAsset Class

Definition

Base class for timed video and audio.

[Foundation.Register("AVAsset", true)]
[ObjCRuntime.Unavailable(ObjCRuntime.PlatformName.WatchOS, ObjCRuntime.PlatformArchitecture.All, null)]
public class AVAsset : Foundation.NSObject, Foundation.INSCopying, IDisposable
type AVAsset = class
    inherit NSObject
    interface INSCopying
    interface INativeObject
    interface IDisposable
Inheritance
Derived
Attributes
Implements

Remarks

An AVAsset represents one or more media assets. These are held in its Tracks property. Additionally, AVAssets include metadata, track grouping, and preferences about the media.

Because media assets such as movies are large, instantiating an AVAsset will not automatically load the file. Properties are loaded when they are queried or via explicit calls to LoadValuesTaskAsync(String[]) or LoadValuesAsynchronously(String[], Action).

During playback, the current presentation state of an AVAsset is represented by an AVPlayerItem object, and the playback is controlled by a AVPlayer:

Constructors

AVAsset(IntPtr) AVAsset(IntPtr)

A constructor used when creating managed representations of unmanaged objects; Called by the runtime.

AVAsset(NSObjectFlag) AVAsset(NSObjectFlag)

Constructor to call on derived classes to skip initialization and merely allocate the object.

Properties

AllMediaSelections AllMediaSelections
AvailableChapterLocales AvailableChapterLocales

The NSLocales available from ChapterMetadataGroups(NSLocale, AVMetadataItem[]).

AvailableMediaCharacteristicsWithMediaSelectionOptions AvailableMediaCharacteristicsWithMediaSelectionOptions

A set of media characteristics for which a media selection option is available.

AvailableMetadataFormats AvailableMetadataFormats

Metadata formats available for the asset.

CanContainFragments CanContainFragments

Gets a Boolean value that tells whether the asset can be extended by fragments.

ChapterMetadataGroupsDidChangeNotification ChapterMetadataGroupsDidChangeNotification

Notification constant for ChapterMetadataGroupsDidChange

Class Class Inherited from NSObject
ClassHandle ClassHandle

The handle for this class.

CommonMetadata CommonMetadata

Metadata keys that are available.

CompatibleWithAirPlayVideo CompatibleWithAirPlayVideo

Gets a Boolean value that tells whether the asset works with AirPlay Video.

CompatibleWithSavedPhotosAlbum CompatibleWithSavedPhotosAlbum

Whether the asset can be saved to the "Saved Photos" album.

Composable Composable

Whether the asset can be used within a segment of a AVCompositionTrack.

ContainsFragments ContainsFragments

Gets a Boolean value that tells whether the asset has been extended by one or more fragments.

ContainsFragmentsDidChangeNotification ContainsFragmentsDidChangeNotification

Notification constant for ContainsFragmentsDidChange

CreationDate CreationDate

The date the asset was created.

DebugDescription DebugDescription

A developer-meaningful description of this object.

(Inherited from NSObject)
Description Description

Description of the object, the Objective-C version of ToString.

(Inherited from NSObject)
Duration Duration

The duration of the asset in CMTime.

DurationDidChangeNotification DurationDidChangeNotification

Notification constant for DurationDidChange

Exportable Exportable

Whether the asset can be exported using a AVAssetExportSession.

Handle Handle

Handle (pointer) to the unmanaged object representation.

(Inherited from NSObject)
IsDirectBinding IsDirectBinding Inherited from NSObject
IsProxy IsProxy Inherited from NSObject
Lyrics Lyrics

The lyrics of the asset, in the current locale.

MediaSelectionGroupsDidChangeNotification MediaSelectionGroupsDidChangeNotification

Notification constant for MediaSelectionGroupsDidChange

Metadata Metadata

Gets an array that contains all the metadata for the asset.

NaturalSize NaturalSize

Developers should not use this deprecated property. Developers should use 'NaturalSize/PreferredTransform' as appropriate on the video track instead.

OverallDurationHint OverallDurationHint

Gets the combined duration of all existing fragments and those that may be added.

Playable Playable

Whether the asset or its URL can be used with a AVPlayerItem.

PreferredMediaSelection PreferredMediaSelection

Gets the default media selections.

PreferredRate PreferredRate

The rate at which this asset should be played.

PreferredTransform PreferredTransform

Preferred affine transformation to apply to the visual content of the asset for rendering.

PreferredVolume PreferredVolume

Preferred asset volume.

ProtectedContent ProtectedContent

Whether the asset has protected content.

ProvidesPreciseDurationAndTiming ProvidesPreciseDurationAndTiming

Whether the asset provides precise duration and timing information.

Readable Readable

Whether the asset's media data is compatible with AVAssetReader.

ReferenceRestrictions ReferenceRestrictions

Whether external references (such as external URLs) should be followed or not.

RetainCount RetainCount

Returns the current Objective-C retain count for the object.

(Inherited from NSObject)
Self Self Inherited from NSObject
Superclass Superclass Inherited from NSObject
SuperHandle SuperHandle

Handle used to represent the methods in the base class for this NSObject.

(Inherited from NSObject)
TrackGroups TrackGroups

The AVAssetTrackGroups comprising the asset.

Tracks Tracks

The tracks contained in the asset.

UnusedTrackId UnusedTrackId

Gets a track ID that is not used by any of the asset's tracks.

WasDefragmentedNotification WasDefragmentedNotification

Notification constant for WasDefragmented

Zone Zone Inherited from NSObject

Methods

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr) AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)

Registers an object for being observed externally (using NSString keyPath).   Observed changes are dispatched to the observer’s object ObserveValue(NSString, NSObject, NSDictionary, IntPtr) method.

(Inherited from NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr) AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)

Registers an object for being observed externally (using string keyPath).   Observed changes are dispatched to the observer’s object ObserveValue(NSString, NSObject, NSDictionary, IntPtr) method.

(Inherited from NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>) AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)

Registers an object for being observed externally using an arbitrary method.

(Inherited from NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>) AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)

Registers an object for being observed externally using an arbitrary method.

(Inherited from NSObject)
AwakeFromNib() AwakeFromNib()

Called after the object has been loaded from the nib file. Overriders must call base.AwakeFromNib().

(Inherited from NSObject)
BeginInvokeOnMainThread(Action) BeginInvokeOnMainThread(Action) Inherited from NSObject
BeginInvokeOnMainThread(Selector, NSObject) BeginInvokeOnMainThread(Selector, NSObject)

Invokes asynchrously the specified code on the main UI thread.

(Inherited from NSObject)
Bind(NSString, NSObject, String, NSDictionary) Bind(NSString, NSObject, String, NSDictionary) Inherited from NSObject
Bind(String, NSObject, String, NSDictionary) Bind(String, NSObject, String, NSDictionary) Inherited from NSObject
BindingInfo(String) BindingInfo(String) Inherited from NSObject
BindingOptionDescriptions(String) BindingOptionDescriptions(String) Inherited from NSObject
BindingValueClass(String) BindingValueClass(String) Inherited from NSObject
CancelLoading() CancelLoading()

Cancels loading.

ChapterMetadataGroups(NSLocale, AVMetadataItem[]) ChapterMetadataGroups(NSLocale, AVMetadataItem[])

Retrieves chapter title information.

CommitEditing() CommitEditing() Inherited from NSObject
CommitEditing(NSObject, Selector, IntPtr) CommitEditing(NSObject, Selector, IntPtr) Inherited from NSObject
ConformsToProtocol(IntPtr) ConformsToProtocol(IntPtr)

Invoked to determine if this object implements the specified protocol.

(Inherited from NSObject)
Copy() Copy()

Performs a copy of the underlying Objective-C object.

(Inherited from NSObject)
Copy(NSZone) Copy(NSZone)

Performs a copy of the underlying Objective-C object.

DangerousAutorelease() DangerousAutorelease() Inherited from NSObject
DangerousRelease() DangerousRelease() Inherited from NSObject
DangerousRetain() DangerousRetain() Inherited from NSObject
DidChange(NSKeyValueChange, NSIndexSet, NSString) DidChange(NSKeyValueChange, NSIndexSet, NSString)

Indicates a change occurred to the indexes for a to-many relationship.

(Inherited from NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet) DidChange(NSString, NSKeyValueSetMutationKind, NSSet) Inherited from NSObject
DidChangeValue(String) DidChangeValue(String)

Indicates that a change occurred on the specified key.

(Inherited from NSObject)
Dispose() Dispose()

Releases the resources used by the NSObject object.

(Inherited from NSObject)
Dispose(Boolean) Dispose(Boolean)

Releases the resources used by the NSObject object.

(Inherited from NSObject)
DoesNotRecognizeSelector(Selector) DoesNotRecognizeSelector(Selector)

Indicates that this object does not recognize the specified selector.

(Inherited from NSObject)
Equals(NSObject) Equals(NSObject) Inherited from NSObject
Equals(Object) Equals(Object) Inherited from NSObject
ExposedBindings() ExposedBindings() Inherited from NSObject
FromUrl(NSUrl) FromUrl(NSUrl)

Factory method that returns a AVUrlAsset.

GetBindingInfo(NSString) GetBindingInfo(NSString) Inherited from NSObject
GetBindingOptionDescriptions(NSString) GetBindingOptionDescriptions(NSString) Inherited from NSObject
GetBindingValueClass(NSString) GetBindingValueClass(NSString) Inherited from NSObject
GetChapterMetadataGroups(NSLocale, AVMetadataItem[]) GetChapterMetadataGroups(NSLocale, AVMetadataItem[])

Returns an array that contains IETF BCP 47 language identifiers that indicate the preferred language order for a chapter.

GetChapterMetadataGroupsBestMatchingPreferredLanguages(String[]) GetChapterMetadataGroupsBestMatchingPreferredLanguages(String[])

Retrieves chapter metadata for the locale that best matches the IETF BCP 47 language identifers.

GetDictionaryOfValuesFromKeys(NSString[]) GetDictionaryOfValuesFromKeys(NSString[])

Retrieves the values of the specified keys.

(Inherited from NSObject)
GetHashCode() GetHashCode()

Generates a hash code for the current instance.

(Inherited from NSObject)
GetMediaSelectionGroupForMediaCharacteristic(AVMediaCharacteristics) GetMediaSelectionGroupForMediaCharacteristic(AVMediaCharacteristics)

Returns a media selection group whose options have the indicated avMediaCharacteristic.

GetMetadataForFormat(AVMetadataFormat) GetMetadataForFormat(AVMetadataFormat)

Returns an array that contains a metadata item for each item in the container that is specified by format.

GetMetadataForFormat(NSString) GetMetadataForFormat(NSString)

Returns an array that contains a metadata item for each item in the container that is specified by format.

GetMethodForSelector(Selector) GetMethodForSelector(Selector) Inherited from NSObject
GetNativeField(String) GetNativeField(String) Inherited from NSObject
GetNativeHash() GetNativeHash() Inherited from NSObject
GetTracks(AVMediaCharacteristics) GetTracks(AVMediaCharacteristics)

Returns an array of tracks that have the specified characteristic.

GetTracks(AVMediaTypes) GetTracks(AVMediaTypes)

Returns an array of tracks of the specified media type.

Init() Init() Inherited from NSObject
InitializeHandle(IntPtr) InitializeHandle(IntPtr) Inherited from NSObject
InitializeHandle(IntPtr, String) InitializeHandle(IntPtr, String) Inherited from NSObject
Invoke(Action, Double) Invoke(Action, Double) Inherited from NSObject
Invoke(Action, TimeSpan) Invoke(Action, TimeSpan) Inherited from NSObject
InvokeOnMainThread(Action) InvokeOnMainThread(Action) Inherited from NSObject
InvokeOnMainThread(Selector, NSObject) InvokeOnMainThread(Selector, NSObject)

Invokes synchrously the specified code on the main UI thread.

(Inherited from NSObject)
IsEqual(NSObject) IsEqual(NSObject) Inherited from NSObject
IsKindOfClass(Class) IsKindOfClass(Class) Inherited from NSObject
IsMemberOfClass(Class) IsMemberOfClass(Class) Inherited from NSObject
LoadValuesAsynchronously(String[], Action) LoadValuesAsynchronously(String[], Action)

Asks the asset to load the specified keys (unless they're already loaded).

LoadValuesTaskAsync(String[]) LoadValuesTaskAsync(String[])

Asks the asset to load the specified keys (unless they're already loaded).

MarkDirty() MarkDirty()

Promotes a regular peer object (IsDirectBinding is true) into a toggleref object.

(Inherited from NSObject)
MediaSelectionGroupForMediaCharacteristic(String) MediaSelectionGroupForMediaCharacteristic(String)

Returns options for the passed in avMediaCharacteristic.

MetadataForFormat(String) MetadataForFormat(String)

Returns the metadata items available for the specified format.

MutableCopy() MutableCopy()

Creates a mutable copy of the specified NSObject.

(Inherited from NSObject)
ObjectDidEndEditing(NSObject) ObjectDidEndEditing(NSObject) Inherited from NSObject
ObserveValue(NSString, NSObject, NSDictionary, IntPtr) ObserveValue(NSString, NSObject, NSDictionary, IntPtr)

Indicates that the value at the specified keyPath relative to this object has changed.

(Inherited from NSObject)
PerformSelector(Selector) PerformSelector(Selector) Inherited from NSObject
PerformSelector(Selector, NSObject) PerformSelector(Selector, NSObject) Inherited from NSObject
PerformSelector(Selector, NSObject, Double) PerformSelector(Selector, NSObject, Double)

Invokes the selector on the current instance and if the obj is not null, it passes this as its single parameter.

(Inherited from NSObject)
PerformSelector(Selector, NSObject, Double, NSString[]) PerformSelector(Selector, NSObject, Double, NSString[]) Inherited from NSObject
PerformSelector(Selector, NSObject, NSObject) PerformSelector(Selector, NSObject, NSObject) Inherited from NSObject
PerformSelector(Selector, NSThread, NSObject, Boolean) PerformSelector(Selector, NSThread, NSObject, Boolean) Inherited from NSObject
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[]) PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[]) Inherited from NSObject
PrepareForInterfaceBuilder() PrepareForInterfaceBuilder() Inherited from NSObject
RemoveObserver(NSObject, NSString) RemoveObserver(NSObject, NSString)

Stops the specified observer from receiving further notifications of changed values for the specified keyPath.

(Inherited from NSObject)
RemoveObserver(NSObject, NSString, IntPtr) RemoveObserver(NSObject, NSString, IntPtr)

Stops the specified observer from receiving further notifications of changed values for the specified keyPath and context.

(Inherited from NSObject)
RemoveObserver(NSObject, String) RemoveObserver(NSObject, String)

Stops the specified observer from receiving further notifications of changed values for the specified keyPath.

(Inherited from NSObject)
RemoveObserver(NSObject, String, IntPtr) RemoveObserver(NSObject, String, IntPtr)

Stops the specified observer from receiving further notifications of changed values for the specified keyPath and context.

(Inherited from NSObject)
RespondsToSelector(Selector) RespondsToSelector(Selector)

Whether this object recognizes the specified selector.

(Inherited from NSObject)
SetNativeField(String, NSObject) SetNativeField(String, NSObject) Inherited from NSObject
SetNilValueForKey(NSString) SetNilValueForKey(NSString)

Sets the value of the specified key to null.

(Inherited from NSObject)
SetValueForKey(NSObject, NSString) SetValueForKey(NSObject, NSString)

Sets the value of the property specified by the key to the specified value.

(Inherited from NSObject)
SetValueForKeyPath(IntPtr, NSString) SetValueForKeyPath(IntPtr, NSString)

A constructor used when creating managed representations of unmanaged objects; Called by the runtime.

(Inherited from NSObject)
SetValueForKeyPath(NSObject, NSString) SetValueForKeyPath(NSObject, NSString)

Sets the value of a property that can be reached using a keypath.

(Inherited from NSObject)
SetValueForUndefinedKey(NSObject, NSString) SetValueForUndefinedKey(NSObject, NSString)

Indicates an attempt to write a value to an undefined key. If not overridden, raises an NSUndefinedKeyException.

(Inherited from NSObject)
SetValuesForKeysWithDictionary(NSDictionary) SetValuesForKeysWithDictionary(NSDictionary)

Sets the values of this NSObject to those in the specified dictionary.

(Inherited from NSObject)
StatusOfValue(String, NSError) StatusOfValue(String, NSError)

Returns the loading status for the specified key.

ToString() ToString()

Returns a string representation of the value of the current instance.

(Inherited from NSObject)
TracksWithMediaCharacteristic(String) TracksWithMediaCharacteristic(String)

The tracks in the asset that match the given media characteristic.

TracksWithMediaType(String) TracksWithMediaType(String)

The tracks in the asset that match the given media type.

TrackWithTrackID(Int32) TrackWithTrackID(Int32)

The track which has the associated Track ID.

Unbind(NSString) Unbind(NSString) Inherited from NSObject
Unbind(String) Unbind(String) Inherited from NSObject
ValueForKey(NSString) ValueForKey(NSString)

Returns the value of the property associated with the specified key.

(Inherited from NSObject)
ValueForKeyPath(NSString) ValueForKeyPath(NSString)

Returns the value of a property that can be reached using a keypath.

(Inherited from NSObject)
ValueForUndefinedKey(NSString) ValueForUndefinedKey(NSString)

Indicates an attempt to read a value of an undefined key. If not overridden, raises an NSUndefinedKeyException.

(Inherited from NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString) WillChange(NSKeyValueChange, NSIndexSet, NSString)

Indicates that the values of the specified indices in the specified key are about to change.

(Inherited from NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet) WillChange(NSString, NSKeyValueSetMutationKind, NSSet) Inherited from NSObject
WillChangeValue(String) WillChangeValue(String)

Indicates that the value of the specified key is about to change.

(Inherited from NSObject)

Extension Methods

ObjectDidBeginEditing(NSObject, INSEditor) ObjectDidBeginEditing(NSObject, INSEditor)
ObjectDidEndEditing(NSObject, INSEditor) ObjectDidEndEditing(NSObject, INSEditor)
GetValidModes(NSObject, NSFontPanel) GetValidModes(NSObject, NSFontPanel)
ValidateToolbarItem(NSObject, NSToolbarItem) ValidateToolbarItem(NSObject, NSToolbarItem)
GetDebugDescription(INSObjectProtocol) GetDebugDescription(INSObjectProtocol)
AcceptsPreviewPanelControl(NSObject, QLPreviewPanel) AcceptsPreviewPanelControl(NSObject, QLPreviewPanel)
BeginPreviewPanelControl(NSObject, QLPreviewPanel) BeginPreviewPanelControl(NSObject, QLPreviewPanel)
EndPreviewPanelControl(NSObject, QLPreviewPanel) EndPreviewPanelControl(NSObject, QLPreviewPanel)
GetAccessibilityCustomRotors(NSObject) GetAccessibilityCustomRotors(NSObject)

Gets the array of UIAccessibilityCustomRotor objects appropriate for this object.

SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[]) SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])

Sets the array of UIAccessibilityCustomRotor objects appropriate for this object.

Applies to

See also