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 o NSObject. Implementa o <NSCopy>.
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... | |
| (id __nullable) | - objectForKey: |
| Lê o valor de um campo. Mais... | |
| (void) | - setString:forKey: |
| Armazena um valor em um campo de string. Mais... | |
| (NSString *__nullable) | - 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... | |
| (NSDate *__nullable) | - dateForKey: |
| Lê o valor de um campo de data da representação restrita à ISO-8601 da data. Mais... | |
| (NSString *__nullable) | - 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... | |
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.
| - (id __nullable) 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.
| - (NSString *__nullable) 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.
| - (NSDate *__nullable) 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.
| - (NSString *__nullable) 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.
Detalhes da propriedade
|
readnonatomicassign |
O tipo de metadados.