O pacote org.osmf.traits fornece os blocos de criação para criação de característica de mídia específicas. As características definem os recursos de um elemento de mídia.
As diferentes implementações de um elemento de mídia agregam conjuntos de características diferentes dependendo das características da mídia representadas por elas. Por exemplo, um elemento de áudio pode agregar as características IAudible, IPlayable, ITemporal e ILoadable. As características individuais definem os recursos do elemento de mídia, independentemente da implementação do elemento de mídia específico. Para uma elemento de mídia que possui a característica ILoadable, a característica fornece o recurso do elemento de carregar e cancelar o carregamento. De modo semelhante, a implementação da característica IPlayable fornece o recurso de auto-reprodução do elemento de mídia.
Uma característica é adicionada a um elemento de mídia por meio do método MediaElement.addTrait() do elemento.
A implementação das características de mídia baseia-se nos seguintes princípios:
- As características são independentes umas das outras. Portanto, uma característica de mídia não expande outra característica de mídia.
- As características despacham seus próprios eventos. As implementações das características podem ser derivadas da classe MediaTraitBase, que expande EventDispatcher e implementa IMediaTrait para manipular o envio de eventos.
- As características são identificadas pela classe de enumeração MediaTraitType.
- As características devem ser implementadas em classes separadas.
As interfaces de características têm seu uso direcionado a classes de elementos de mídia. Elas são entidades genéricas voltadas para o exterior, caracterizadas principalmente por getters sem setters, exceto pelas características que exigem propriedades definíveis externamente, como propriedades de volume ou panorama de um IAudible.
As classes de características básicas são usadas por implementações que pertencem à subclasse MediaElement. No geral, elas têm setters e getters.
| Classe | Descrição | |
|---|---|---|
| AlternativeAudioTrait | AlternativeAudioTrait defines the trait interface for media supporting alternative audio streams. | |
| AudioTrait | AudioTrait defines the trait interface for media that have audio. | |
| BufferTrait | BufferTrait defines the trait interface for media that can use a data buffer. | |
| DisplayObjectTrait | DisplayObjectTrait defines the trait interface for media that expose a DisplayObject, and which may have intrinsic dimensions. | |
| DRMState | DRMState is the enumeration of possible DRM-specific states that a piece of media can be in. | |
| DRMTrait | DRMTrait defines the trait interface for media which can be protected by digital rights management (DRM) technology. | |
| DVRTrait | DVRTrait defines the trait interface for media that can be played while in the process of being recorded, as if with a digital video recorder (DVR). | |
| DynamicStreamTrait | DynamicStreamTrait defines the trait interface for media supporting dynamic stream switching. | |
| LoaderBase | LoaderBase is the base class for objects that are capable of loading and unloading LoadTraits. | |
| LoadState | LoadState is the enumeration of possible states that a LoadTrait can be in. | |
| LoadTrait | LoadTrait defines the trait interface for media that must be loaded before it can be presented. | |
| MediaTraitBase | A MediaTraitBase is the encapsulation of a trait or capability that's inherent to a MediaElement. | |
| MediaTraitType | MediaTraitType is the enumeration of all possible media trait types. | |
| PlayState | PlayState is the enumeration of possible states that a PlayTrait can be in. | |
| PlayTrait | PlayTrait defines the trait interface for media whose playback can be started and stopped. | |
| SeekTrait | SeekTrait defines the trait interface for media that can be instructed to jump to a position in time. | |
| TimeTrait | TimeTrait defines the trait interface for media that have a duration and a currentTime. | |
| TraitEventDispatcher | TraitEventDispatcher is a utility class that exposes a uniform interface for receiving trait events from a MediaElement. |
Wed Jun 13 2018, 11:25 AM Z