개요

미디어 메타데이터의 컨테이너입니다.

메타데이터에는 미디어 유형, 선택사항인 이미지 목록, 메타데이터 필드 모음이 있습니다. 일반적인 메타데이터 필드의 키는 상수로 사전 정의되지만 애플리케이션은 자체적으로 추가 필드를 정의하고 사용할 수 있습니다.

사전 정의된 필드의 값에는 사전 정의된 유형이 있습니다. 예를 들어 트랙 번호는 NSInteger이고 생성일은 날짜와 시간의 ISO-8601 표현을 포함하는 NSString입니다. 필드에 잘못된 유형의 값을 저장하려고 하면 NSInvalidArgumentException이 발생합니다.

Cast 프로토콜은 특정 미디어 유형에 사용할 수 있는 메타데이터 필드를 제한합니다. MediaMetadata 객체가 Cast 수신기에 전송하기 위해 JSON으로 직렬화되면 특정 미디어 유형에 지원되지 않는 사전 정의된 필드는 직렬화된 형식에 포함되지 않지만 애플리케이션 정의 필드는 항상 포함됩니다. 사전 정의된 필드의 전체 목록은 다음과 같습니다.

필드	값 유형	유효한 메타데이터 유형
kGCKMetadataKeyCreationDate	NSDate	GCKMediaMetadataTypePhoto
kGCKMetadataKeyReleaseDate	NSDate	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyBroadcastDate	NSDate	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyTitle	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie, GCKMediaMetadataTypeTVShow, GCKMediaMetadataTypeMusicTrack, GCKMediaMetadataTypePhoto
kGCKMetadataKeySubtitle	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMovie
kGCKMetadataKeyArtist	NSString	GCKMediaMetadataTypeGeneric, GCKMediaMetadataTypeMusicTrack, GCKMediaMetadataTypePhoto
kGCKMetadataKeyAlbumArtist	NSString	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyAlbumTitle	NSString	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyComposer	NSString	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyDiscNumber	NSInteger	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeyTrackNumber	NSInteger	GCKMediaMetadataTypeMusicTrack
kGCKMetadataKeySeasonNumber	NSInteger	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyEpisodeNumber	NSInteger	GCKMediaMetadataTypeTVShow
kGCKMetadataKeySeriesTitle	NSString	GCKMediaMetadataTypeTVShow
kGCKMetadataKeyStudio	NSString	GCKMediaMetadataTypeMovie
kGCKMetadataKeyWidth	NSInteger	GCKMediaMetadataTypePhoto
kGCKMetadataKeyHeight	NSInteger	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationName	NSString	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLatitude	double	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	double	GCKMediaMetadataTypePhoto

NSObject를 상속합니다. <NSCopying>을 구현합니다.

인스턴스 메서드 요약
(instancetype)	- initWithMetadataType:
	지정된 미디어 유형으로 새 빈 MediaMetadata를 초기화합니다. 더보기

(instancetype)	- init
	일반 메타데이터 유형으로 초기화합니다. 더보기

(GCKMediaMetadataType)	- metadataType
	메타데이터 유형입니다. 더보기

(NSArray *)	- images
	이미지 목록을 가져옵니다. 더보기

(void)	- removeAllMediaImages
	현재 이미지를 모두 삭제합니다. 더보기

(void)	- addImage:
	이미지 목록에 이미지를 추가합니다. 더보기

(BOOL)	- containsKey:
	객체에 지정된 키가 있는 필드가 포함되어 있는지 테스트합니다. 더보기

(NSArray< NSString * > *)	- allKeys
	객체에 있는 모든 필드의 키 집합을 반환합니다. 더보기

(id __nullable)	- objectForKey:
	필드 값을 읽습니다. 더보기

(void)	- setString:forKey:
	문자열 필드에 값을 저장합니다. 더보기

(NSString *__nullable)	- stringForKey:
	문자열 필드의 값을 읽습니다. 더보기

(void)	- setInteger:forKey:
	정수 필드에 값을 저장합니다. 더보기

(NSInteger)	- integerForKey:
	정수 필드의 값을 읽습니다. 더보기

(NSInteger)	- integerForKey:defaultValue:
	정수 필드의 값을 읽습니다. 더보기

(void)	- setDouble:forKey:
	double 필드에 값을 저장합니다. 더보기

(double)	- doubleForKey:
	double 필드의 값을 읽습니다. 더보기

(double)	- doubleForKey:defaultValue:
	double 필드의 값을 읽습니다. 더보기

(void)	- setDate:forKey:
	날짜 필드의 값을 제한된 ISO-8601 날짜 표현으로 저장합니다. 더보기

(NSDate *__nullable)	- dateForKey:
	제한된 ISO-8601 날짜 표현에서 날짜 필드의 값을 읽습니다. 더보기

(NSString *__nullable)	- dateAsStringForKey:
	날짜 필드의 값을 문자열로 읽습니다. 더보기

공개 속성
NSString *const	kGCKMetadataKeyCreationDate
	문자열 키: 생성 날짜입니다. 더보기

NSString *const	kGCKMetadataKeyReleaseDate
	문자열 키: 출시일입니다. 더보기

NSString *const	kGCKMetadataKeyBroadcastDate
	문자열 키: 방송 날짜입니다. 더보기

NSString *const	kGCKMetadataKeyTitle
	문자열 키: 제목 더보기

NSString *const	kGCKMetadataKeySubtitle
	문자열 키: 부제목 더보기

NSString *const	kGCKMetadataKeyArtist
	문자열 키: 아티스트 더보기

NSString *const	kGCKMetadataKeyAlbumArtist
	문자열 키: 앨범 아티스트입니다. 더보기

NSString *const	kGCKMetadataKeyAlbumTitle
	문자열 키: 앨범 제목입니다. 더보기

NSString *const	kGCKMetadataKeyComposer
	문자열 키: Composer 더보기

NSString *const	kGCKMetadataKeyDiscNumber
	정수 키: 디스크 번호 더보기

NSString *const	kGCKMetadataKeyTrackNumber
	정수 키: 트랙 번호입니다. 더보기

NSString *const	kGCKMetadataKeySeasonNumber
	정수 키: 시즌 번호입니다. 더보기

NSString *const	kGCKMetadataKeyEpisodeNumber
	정수 키: 에피소드 번호입니다. 더보기

NSString *const	kGCKMetadataKeySeriesTitle
	문자열 키: 시리즈 제목입니다. 더보기

NSString *const	kGCKMetadataKeyStudio
	문자열 키: Studio 더보기

NSString *const	kGCKMetadataKeyWidth
	정수 키: 너비입니다. 더보기

NSString *const	kGCKMetadataKeyHeight
	정수 키: 높이입니다. 더보기

NSString *const	kGCKMetadataKeyLocationName
	문자열 키: 위치 이름입니다. 더보기

NSString *const	kGCKMetadataKeyLocationLatitude
	이중 키: 위치 위도 더보기

NSString *const	kGCKMetadataKeyLocationLongitude
	이중 키: 위치 경도입니다. 더보기

숙박 시설 요약
GCKMediaMetadataType	metadataType
	메타데이터 유형입니다. 더보기

메소드 세부정보

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

지정된 미디어 유형으로 새 빈 MediaMetadata를 초기화합니다.

지정된 이니셜라이저입니다.

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

일반 메타데이터 유형으로 초기화합니다.

- (GCKMediaMetadataType) metadataType

메타데이터 유형입니다.

- (NSArray *) images

이미지 목록을 가져옵니다.

- (void) removeAllMediaImages

현재 이미지를 모두 삭제합니다.

- (void) addImage: (GCKImage *) image

이미지 목록에 이미지를 추가합니다.

Parameters

image The image to add.

- (BOOL) containsKey: (NSString *) key

객체에 지정된 키가 있는 필드가 포함되어 있는지 테스트합니다.

Parameters

key The key.

반환 값: YES, 그렇지 않으면 NO

- (NSArray<NSString *> *) allKeys

객체에 있는 모든 필드의 키 집합을 반환합니다.

- (id __nullable) objectForKey: (NSString *) key

필드 값을 읽습니다.

Parameters

key	The key for the field.

반환 값: 필드의 값입니다. 필드가 설정되지 않은 경우 nil입니다.

- (void) setString:	(NSString *)	value
forKey:	(NSString *)	key

문자열 필드에 값을 저장합니다.

Parameters

value	The new value for the field.
key	The key for the field.

예외

NSInvalidArgumentException 키가 문자열 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (NSString *__nullable) stringForKey: (NSString *) key

문자열 필드의 값을 읽습니다.

Parameters

key	The key for the field.

반환 값: 필드의 값입니다. 필드가 설정되지 않은 경우 nil입니다.

예외

NSInvalidArgumentException 키가 문자열 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (void) setInteger:	(NSInteger)	value
forKey:	(NSString *)	key

정수 필드에 값을 저장합니다.

Parameters

value	The new value for the field.
key	The key for the field.

예외

NSInvalidArgumentException 키가 정수 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (NSInteger) integerForKey: (NSString *) key

정수 필드의 값을 읽습니다.

Parameters

key	The key for the field.

반환 값: 필드의 값입니다. 필드가 설정되지 않은 경우 0입니다.

예외

NSInvalidArgumentException 키가 정수 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (NSInteger) integerForKey:	(NSString *)	key
defaultValue:	(NSInteger)	defaultValue

정수 필드의 값을 읽습니다.

Parameters

key	The key for the field.
defaultValue	The value to return if the field has not been set.

반환 값: 필드의 값입니다. 필드가 설정되지 않은 경우 지정된 기본값입니다.

예외

NSInvalidArgumentException 키가 정수 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (void) setDouble:	(double)	value
forKey:	(NSString *)	key

double 필드에 값을 저장합니다.

Parameters

value	The new value for the field.
key	The key for the field.

예외

NSInvalidArgumentException 키가 double 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (double) doubleForKey: (NSString *) key

double 필드의 값을 읽습니다.

Parameters

key	The key for the field.

반환 값: 필드의 값입니다. 필드가 설정되지 않은 경우 0입니다.

예외

NSInvalidArgumentException 키가 double 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (double) doubleForKey:	(NSString *)	key
defaultValue:	(double)	defaultValue

double 필드의 값을 읽습니다.

Parameters

defaultValue	The value to return if the field has not been set.
key	The key for the field.

반환 값: 필드의 값입니다. 필드가 설정되지 않은 경우 지정된 기본값입니다.

예외

NSInvalidArgumentException 키가 double 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (void) setDate:	(NSDate *)	date
forKey:	(NSString *)	key

날짜 필드의 값을 제한된 ISO-8601 날짜 표현으로 저장합니다.

Parameters

date	The new value for the field.
key	The key for the field.

예외

NSInvalidArgumentException 키가 날짜 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (NSDate *__nullable) dateForKey: (NSString *) key

제한된 ISO-8601 날짜 표현에서 날짜 필드의 값을 읽습니다.

Parameters

key	The field name.

반환 값: 날짜 또는 이 필드가 설정되지 않은 경우 nil

예외

NSInvalidArgumentException 키가 날짜 필드가 아닌 사전 정의된 필드를 참조하는 경우

- (NSString *__nullable) dateAsStringForKey: (NSString *) key

날짜 필드의 값을 문자열로 읽습니다.

Parameters

key	The field name.

반환 값: 날짜의 제한된 ISO-8601 표현을 포함하는 문자열로 된 날짜입니다. 이 필드가 설정되지 않은 경우 nil입니다.

예외

NSInvalidArgumentException 키가 날짜 필드가 아닌 사전 정의된 필드를 참조하는 경우

회원 데이터 문서

- (NSString* const) kGCKMetadataKeyCreationDate

문자열 키: 생성 날짜입니다.

값은 미디어가 생성된 날짜 및/또는 시간이며, ISO-8601 형식입니다. 예를 들어 사진이 촬영된 날짜와 시간 또는 음악이 녹음된 날짜와 시간일 수 있습니다.

- (NSString* const) kGCKMetadataKeyReleaseDate

문자열 키: 출시일입니다.

값은 미디어가 출시된 날짜 및/또는 시간이며, ISO-8601 형식입니다. 예를 들어 영화나 음악 앨범이 출시된 날짜일 수 있습니다.

- (NSString* const) kGCKMetadataKeyBroadcastDate

문자열 키: 방송 날짜입니다.

값은 미디어가 처음 방송된 날짜 및/또는 시간이며, ISO-8601 형식으로 나타냅니다. 예를 들어 TV 프로그램 에피소드가 처음 방송된 날짜일 수 있습니다.

- (NSString* const) kGCKMetadataKeyTitle

문자열 키: 제목

미디어의 제목입니다. 예를 들어 노래, 영화 또는 TV 프로그램 에피소드의 제목이 될 수 있습니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeySubtitle

문자열 키: 부제목

미디어의 부제목입니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeyArtist

문자열 키: 아티스트

미디어를 만든 아티스트의 이름입니다. 예를 들어 음악가, 연주자 또는 사진가의 이름일 수 있습니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeyAlbumArtist

문자열 키: 앨범 아티스트입니다.

앨범을 제작한 아티스트의 이름입니다. 예를 들어 DJ 믹스와 같은 편집 앨범에서 앨범 아티스트는 앨범에 있는 개별 노래의 아티스트와 동일하지 않을 수 있습니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeyAlbumTitle

문자열 키: 앨범 제목입니다.

음악 트랙이 속한 앨범의 제목입니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeyComposer

문자열 키: Composer

음악 트랙의 작곡가 이름입니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeyDiscNumber

정수 키: 디스크 번호

멀티 디스크 앨범에서 음악 트랙이 속한 디스크 번호 (1부터 시작)입니다.

- (NSString* const) kGCKMetadataKeyTrackNumber

정수 키: 트랙 번호입니다.

앨범 디스크에 있는 음악 트랙의 트랙 번호입니다. 일반적으로 트랙 번호는 1부터 시작하여 계산되지만 앨범 시작 부분의 '숨겨진 트랙'인 경우 이 값이 0일 수 있습니다.

- (NSString* const) kGCKMetadataKeySeasonNumber

정수 키: 시즌 번호입니다.

TV 프로그램 에피소드가 속한 시즌 번호입니다. 일반적으로 시즌 번호는 1부터 시작하여 계산되지만, TV 시리즈의 공식 시작 이전에 제작된 '파일럿' 에피소드인 경우 이 값이 0일 수 있습니다.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

정수 키: 에피소드 번호입니다.

TV 프로그램의 특정 시즌에 속한 에피소드의 번호입니다. 일반적으로 에피소드 번호는 1부터 시작하여 계산되지만, 첫 번째 시즌의 공식 에피소드로 간주되지 않는 '파일럿' 에피소드인 경우 이 값은 0일 수 있습니다.

- (NSString* const) kGCKMetadataKeySeriesTitle

문자열 키: 시리즈 제목입니다.

시리즈의 이름입니다. 예를 들어 TV 프로그램 이름이나 관련 음악 앨범 시리즈의 이름일 수 있습니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeyStudio

문자열 키: Studio

미디어를 제작한 녹음 스튜디오의 이름입니다. 예를 들어 영화 스튜디오 또는 음반사 이름이 여기에 해당할 수 있습니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeyWidth

정수 키: 너비입니다.

미디어의 너비(픽셀)입니다. 이는 일반적으로 사진의 크기를 제공하는 데 사용됩니다.

- (NSString* const) kGCKMetadataKeyHeight

정수 키: 높이입니다.

미디어의 높이(픽셀)입니다. 이는 일반적으로 사진의 크기를 제공하는 데 사용됩니다.

- (NSString* const) kGCKMetadataKeyLocationName

문자열 키: 위치 이름입니다.

미디어가 생성된 위치의 이름입니다. 예를 들어 사진의 위치 또는 영화의 주요 촬영 장소가 될 수 있습니다. 이 값은 표시 용도에 적합합니다.

- (NSString* const) kGCKMetadataKeyLocationLatitude

이중 키: 위치 위도

미디어가 생성된 지리적 위치의 위도 구성요소입니다. 예를 들어 사진의 위치 또는 영화의 주요 촬영 장소가 될 수 있습니다.

- (NSString* const) kGCKMetadataKeyLocationLongitude

이중 키: 위치 경도입니다.

미디어가 생성된 지리적 위치의 경도 구성요소입니다. 예를 들어 사진의 위치 또는 영화의 주요 촬영 장소가 될 수 있습니다.

숙박 시설 세부정보

- (GCKMediaMetadataType) metadataType

readnonatomicassign

메타데이터 유형입니다.

GCKMediaMetadata 클래스 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

개요

인스턴스 메서드 요약

공개 속성

숙박 시설 요약

메소드 세부정보

회원 데이터 문서

숙박 시설 세부정보

GCKMediaMetadata 클래스