Visão geral
Um contêiner para metadados de mídia.
Os metadados têm um tipo de mídia, uma lista opcional de imagens e um conjunto de campos de metadados. As chaves dos campos de metadados comuns são predefinidas como constantes, mas o aplicativo é livre para definir e usar outros campos.
Os valores dos campos predefinidos têm tipos predefinidos. Por exemplo, um número de faixa é um NSInteger e uma data de criação é uma NSString que contém uma representação ISO-8601 de data e hora. A tentativa de armazenar um valor de um tipo incorreto em um campo vai gerar uma NSInvalidArgumentException.
O protocolo do Google Cast limita os campos de metadados que podem ser usados para um determinado tipo de mídia. Quando um objeto MediaMetadata é serializado para JSON para entrega a um receptor do Cast, os campos predefinidos que não são compatíveis com um determinado tipo de mídia não são incluídos no formulário serializado, mas os campos definidos pelo aplicativo sempre são incluídos. Veja a lista completa de campos predefinidos:
Herda NSObject, <NSCOPY> e <NSSecureCoding>.
Resumo do método de instância | |
| (instancetype) | - initWithMetadataType: |
| Inicializa um MediaMetadata novo e vazio com o tipo de mídia especificado. Mais... | |
| (instancetype) | - init |
| Inicializar com o tipo de metadados genérico. Mais... | |
| (GCKMediaMetadataType) | - metadataType |
| O tipo de metadados. Mais... | |
| (NSArray *) | - images |
| Recebe a lista de imagens. Mais... | |
| (void) | - removeAllMediaImages |
| Remove todas as imagens atuais. Mais... | |
| (void) | - addImage: |
| Adiciona uma imagem à lista de imagens. Mais... | |
| (BOOL) | - containsKey: |
| Testa se o objeto contém um campo com a chave especificada. Mais... | |
| (NSArray< NSString * > *) | - allKeys |
| Retorna um conjunto de chaves para todos os campos presentes no objeto. Mais... | |
| (nullable id) | - objectForKey: |
| Lê o valor de um campo. Mais... | |
| (void) | - setString:forKey: |
| Armazena um valor em um campo de string. Mais... | |
| (nullable NSString *) | - stringForKey: |
| Lê o valor de um campo de string. Mais... | |
| (void) | - setInteger:forKey: |
| Armazena um valor em um campo de número inteiro. Mais... | |
| (NSInteger) | - integerForKey: |
| Lê o valor de um campo de número inteiro. Mais... | |
| (NSInteger) | - integerForKey:defaultValue: |
| Lê o valor de um campo de número inteiro. Mais... | |
| (void) | - setDouble:forKey: |
| Armazena um valor em um campo double. Mais... | |
| (double) | - doubleForKey: |
| Lê o valor de um campo double. Mais... | |
| (double) | - doubleForKey:defaultValue: |
| Lê o valor de um campo double. Mais... | |
| (void) | - setDate:forKey: |
| Armazena um valor em um campo de data como uma representação ISO-8601 restrita da data. Mais... | |
| (nullable NSDate *) | - dateForKey: |
| Lê o valor de um campo de data da representação restrita à ISO-8601 da data. Mais... | |
| (nullable NSString *) | - dateAsStringForKey: |
| Lê o valor de um campo de data como uma string. Mais... | |
Atributos públicos | |
| NSString *const | kGCKMetadataKeyCreationDate |
| Chave de string: data de criação. Mais... | |
| NSString *const | kGCKMetadataKeyReleaseDate |
| Chave de string: data de lançamento. Mais... | |
| NSString *const | kGCKMetadataKeyBroadcastDate |
| Chave de string: data de transmissão. Mais... | |
| NSString *const | kGCKMetadataKeyTitle |
| Chave de string: título. Mais... | |
| NSString *const | kGCKMetadataKeySubtitle |
| Chave de string: legenda. Mais... | |
| NSString *const | kGCKMetadataKeyArtist |
| Chave de string: artista. Mais... | |
| NSString *const | kGCKMetadataKeyAlbumArtist |
| Chave de string: artista do álbum. Mais... | |
| NSString *const | kGCKMetadataKeyAlbumTitle |
| Chave de string: título do álbum. Mais... | |
| NSString *const | kGCKMetadataKeyComposer |
| Chave de string: Composer. Mais... | |
| NSString *const | kGCKMetadataKeyDiscNumber |
| Chave de número inteiro: número do disco. Mais... | |
| NSString *const | kGCKMetadataKeyTrackNumber |
| Chave de número inteiro: número da faixa. Mais... | |
| NSString *const | kGCKMetadataKeySeasonNumber |
| Chave de número inteiro: número da temporada. Mais... | |
| NSString *const | kGCKMetadataKeyEpisodeNumber |
| Chave de número inteiro: número do episódio. Mais... | |
| NSString *const | kGCKMetadataKeySeriesTitle |
| Chave de string: título da série. Mais... | |
| NSString *const | kGCKMetadataKeyStudio |
| Chave de string: Studio. Mais... | |
| NSString *const | kGCKMetadataKeyWidth |
| Chave de número inteiro: largura. Mais... | |
| NSString *const | kGCKMetadataKeyHeight |
| Chave de inteiro: altura. Mais... | |
| NSString *const | kGCKMetadataKeyLocationName |
| Chave de string: nome do local. Mais... | |
| NSString *const | kGCKMetadataKeyLocationLatitude |
| Chave dupla: latitude do local. Mais... | |
| NSString *const | kGCKMetadataKeyLocationLongitude |
| Tecla dupla: longitude do local. Mais... | |
| NSString *const | kGCKMetadataKeyBookTitle |
| Chave de string: título do livro. Mais... | |
| NSString *const | kGCKMetadataKeyChapterNumber |
| Chave de número inteiro: número do capítulo. Mais... | |
| NSString *const | kGCKMetadataKeyChapterTitle |
| Chave de string: título do capítulo. Mais... | |
| NSString *const | kGCKMetadataKeySectionDuration |
| Chave dupla: duração da seção. Mais... | |
| NSString *const | kGCKMetadataKeySectionStartTimeInMedia |
| Chave dupla: horário de início da seção na mídia. Mais... | |
| NSString *const | kGCKMetadataKeySectionStartAbsoluteTime |
| Chave dupla: horário de início absoluto da seção. Mais... | |
| NSString *const | kGCKMetadataKeySectionStartTimeInContainer |
| Chave dupla: horário de início da seção no contêiner. Mais... | |
| NSString *const | kGCKMetadataKeyQueueItemID |
| Chave dupla: código do item da fila. Mais... | |
Resumo da propriedade | |
| GCKMediaMetadataType | metadataType |
| O tipo de metadados. Mais... | |
Detalhes dos métodos
| - (instancetype) initWithMetadataType: | (GCKMediaMetadataType) | metadataType |
Inicializa um MediaMetadata novo e vazio com o tipo de mídia especificado.
Inicializador designado.
- Parameters
-
metadataType The media type; one of the GCKMediaMetadataType constants, or a value greater than or equal to GCKMediaMetadataTypeUser for custom media types.
| - (instancetype) init |
Inicializar com o tipo de metadados genérico.
| - (GCKMediaMetadataType) metadataType |
O tipo de metadados.
| - (NSArray *) images |
Recebe a lista de imagens.
| - (void) removeAllMediaImages |
Remove todas as imagens atuais.
| - (void) addImage: | (GCKImage *) | image |
Adiciona uma imagem à lista de imagens.
- Parameters
-
image The image to add.
| - (BOOL) containsKey: | (NSString *) | key |
Testa se o objeto contém um campo com a chave especificada.
- Parameters
-
key The key.
- Retorna
YESse o campo existir,NOcaso contrário.
| - (NSArray<NSString *> *) allKeys |
Retorna um conjunto de chaves para todos os campos presentes no objeto.
| - (nullable id) objectForKey: | (NSString *) | key |
Lê o valor de um campo.
- Parameters
-
key The key for the field.
- Retorna
- O valor do campo ou
nil, se o campo não tiver sido definido.
| - (void) setString: | (NSString *) | value | |
| forKey: | (NSString *) | key | |
Armazena um valor em um campo de string.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de string.
| - (nullable NSString *) stringForKey: | (NSString *) | key |
Lê o valor de um campo de string.
- Parameters
-
key The key for the field.
- Retorna
- O valor do campo ou
nil, se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de string.
| - (void) setInteger: | (NSInteger) | value | |
| forKey: | (NSString *) | key | |
Armazena um valor em um campo de número inteiro.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de número inteiro.
| - (NSInteger) integerForKey: | (NSString *) | key |
Lê o valor de um campo de número inteiro.
- Parameters
-
key The key for the field.
- Retorna
- O valor do campo, ou 0 se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de número inteiro.
| - (NSInteger) integerForKey: | (NSString *) | key | |
| defaultValue: | (NSInteger) | defaultValue | |
Lê o valor de um campo de número inteiro.
- Parameters
-
key The key for the field. defaultValue The value to return if the field has not been set.
- Retorna
- O valor do campo ou o valor padrão fornecido, se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de número inteiro.
| - (void) setDouble: | (double) | value | |
| forKey: | (NSString *) | key | |
Armazena um valor em um campo double.
- Parameters
-
value The new value for the field. key The key for the field.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não é um campo duplo.
| - (double) doubleForKey: | (NSString *) | key |
Lê o valor de um campo double.
- Parameters
-
key The key for the field.
- Retorna
- O valor do campo, ou 0 se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não é um campo duplo.
| - (double) doubleForKey: | (NSString *) | key | |
| defaultValue: | (double) | defaultValue | |
Lê o valor de um campo double.
- Parameters
-
defaultValue The value to return if the field has not been set. key The key for the field.
- Retorna
- O valor do campo ou o valor padrão fornecido, se o campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não é um campo duplo.
| - (void) setDate: | (NSDate *) | date | |
| forKey: | (NSString *) | key | |
Armazena um valor em um campo de data como uma representação ISO-8601 restrita da data.
- Parameters
-
date The new value for the field. key The key for the field.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de data.
| - (nullable NSDate *) dateForKey: | (NSString *) | key |
Lê o valor de um campo de data da representação restrita à ISO-8601 da data.
- Parameters
-
key The field name.
- Retorna
- A data, ou
nil, se esse campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de data.
| - (nullable NSString *) dateAsStringForKey: | (NSString *) | key |
Lê o valor de um campo de data como uma string.
- Parameters
-
key The field name.
- Retorna
- A data como uma string que contém a representação ISO-8601 restrita da data ou
nilse este campo não tiver sido definido.
- Exceções
-
NSInvalidArgumentException se a chave se referir a um campo predefinido que não seja um campo de data.
Documentação de dados dos membros
| - (NSString* const) kGCKMetadataKeyCreationDate |
Chave de string: data de criação.
O valor é a data e/ou hora em que a mídia foi criada, no formato ISO-8601. Por exemplo, pode ser a data e a hora em que uma foto foi tirada ou uma música foi gravada.
| - (NSString* const) kGCKMetadataKeyReleaseDate |
Chave de string: data de lançamento.
O valor é a data e/ou hora em que a mídia foi lançada, no formato ISO-8601. Por exemplo, pode ser a data em que um filme ou um álbum de música foi lançado.
| - (NSString* const) kGCKMetadataKeyBroadcastDate |
Chave de string: data de transmissão.
O valor é a data e/ou hora em que a mídia foi transmitida pela primeira vez, no formato ISO-8601. Por exemplo, essa pode ser a data em que o episódio de um programa de TV foi exibido pela primeira vez.
| - (NSString* const) kGCKMetadataKeyTitle |
Chave de string: título.
O título da mídia. Por exemplo, pode ser o título de uma música, filme ou episódio de programa de TV. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeySubtitle |
Chave de string: legenda.
O subtítulo da mídia. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyArtist |
Chave de string: artista.
O nome do artista que criou a mídia. Por exemplo, pode ser o nome de um músico, intérprete ou fotógrafo. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyAlbumArtist |
Chave de string: artista do álbum.
O nome do artista que produziu o álbum. Por exemplo, em álbuns de compilação, como mixes de DJ, o artista não é necessariamente o mesmo artista das músicas individuais do álbum. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyAlbumTitle |
Chave de string: título do álbum.
O título do álbum do qual a música pertence. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyComposer |
Chave de string: Composer.
Nome do compositor de uma faixa musical. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyDiscNumber |
Chave de número inteiro: número do disco.
O número do disco (contado a partir de 1) ao qual uma música pertence em um álbum com vários discos.
| - (NSString* const) kGCKMetadataKeyTrackNumber |
Chave de número inteiro: número da faixa.
O número da faixa de música em um disco de álbum. Normalmente, os números das faixas são contados a partir de 1. No entanto, esse valor poderá ser 0 se for uma "faixa oculta" no início de um álbum.
| - (NSString* const) kGCKMetadataKeySeasonNumber |
Chave de número inteiro: número da temporada.
É o número da temporada a que um episódio pertence. Normalmente os números de temporadas são contados a partir de 1. No entanto, esse valor pode ser 0 se for um episódio "piloto" anterior ao início oficial de uma série de TV.
| - (NSString* const) kGCKMetadataKeyEpisodeNumber |
Chave de número inteiro: número do episódio.
O número de um episódio em uma determinada temporada de um programa de TV. Normalmente, os números de episódios são contados a partir de 1. No entanto, esse valor poderá ser 0 se for um episódio "piloto" que não será considerado um episódio oficial da primeira temporada.
| - (NSString* const) kGCKMetadataKeySeriesTitle |
Chave de string: título da série.
É o nome de uma série. Por exemplo, pode ser o nome de um programa de TV ou de vários álbuns relacionados. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyStudio |
Chave de string: Studio.
O nome de um estúdio de gravação que produziu uma mídia. Por exemplo, pode ser o nome de um estúdio de cinema ou uma gravadora. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyWidth |
Chave de número inteiro: largura.
É a largura de uma mídia, em pixels. Normalmente, esse atributo é usado para fornecer as dimensões de uma foto.
| - (NSString* const) kGCKMetadataKeyHeight |
Chave de inteiro: altura.
É a altura em pixels da mídia. Normalmente, esse atributo é usado para fornecer as dimensões de uma foto.
| - (NSString* const) kGCKMetadataKeyLocationName |
Chave de string: nome do local.
O nome de um local em que uma mídia foi criada. Por exemplo, pode ser a localização de uma foto ou o local principal de filmagem de um filme. Esse valor é adequado para fins de exibição.
| - (NSString* const) kGCKMetadataKeyLocationLatitude |
Chave dupla: latitude do local.
O componente de latitude da localização geográfica em que a mídia foi criada. Por exemplo, pode ser a localização de uma foto ou o local principal de filmagem de um filme.
| - (NSString* const) kGCKMetadataKeyLocationLongitude |
Tecla dupla: longitude do local.
O componente de longitude do local geográfico em que uma mídia foi criada. Por exemplo, pode ser a localização de uma foto ou o local principal de filmagem de um filme.
| - (NSString* const) kGCKMetadataKeyBookTitle |
Chave de string: título do livro.
É o título do audiolivro.
- Since
- 4,3,5
| - (NSString* const) kGCKMetadataKeyChapterNumber |
Chave de número inteiro: número do capítulo.
É o número de um capítulo de um audiolivro.
- Since
- 4,3,5
| - (NSString* const) kGCKMetadataKeyChapterTitle |
Chave de string: título do capítulo.
É o título de um capítulo de um audiolivro.
- Since
- 4,3,5
| - (NSString* const) kGCKMetadataKeySectionDuration |
Chave dupla: duração da seção.
A duração da seção em segundos. Usado para metadados de fila. Por exemplo, a duração pode ser a duração de um programa de TV em uma fila, a duração de um capítulo de um audiolivro ou a programação de uma transmissão ao vivo longa.
- Since
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartTimeInMedia |
Chave dupla: horário de início da seção na mídia.
O deslocamento do horário de início da seção em relação ao início do item de mídia em segundos. Usado para metadados de fila.
- Since
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime |
Chave dupla: horário de início absoluto da seção.
O horário absoluto do início da seção, em tempo de época em segundos. Usado para metadados de fila.
- Since
- 4.4.1
| - (NSString* const) kGCKMetadataKeySectionStartTimeInContainer |
Chave dupla: horário de início da seção no contêiner.
O deslocamento do horário de início da seção no contêiner completo. Usado para metadados de fila.
- Since
- 4.4.1
| - (NSString* const) kGCKMetadataKeyQueueItemID |
Chave dupla: código do item da fila.
ID do item da fila que inclui o horário de início da seção. Usado para metadados de fila.
- Since
- 4.4.1
Detalhes da propriedade
|
readnonatomicassign |
O tipo de metadados.