GCKMediaMetadata 클래스

GCKMediaMetadata 클래스 참조

개요

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

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

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

Cast 프로토콜은 특정 미디어 유형에 사용할 수 있는 메타데이터 필드를 제한합니다. Cast 수신기에 전송하기 위해 MediaMetadata 객체를 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, <NS copy> 및 <NSSecureCoding>을 상속합니다.

인스턴스 메서드 요약

(instancetype) - initWithMetadataType:
 지정된 미디어 유형을 사용하여 비어 있는 새 MediaMetadata를 초기화합니다. 더보기...
 
(instancetype) - init
 일반 메타데이터 유형으로 초기화합니다. 더보기...
 
(GCKMediaMetadataType- metadataType
 메타데이터 유형입니다. 더보기...
 
(NSArray *) - images
 이미지 목록을 가져옵니다. 더보기...
 
(void) - removeAllMediaImages
 현재 이미지를 모두 삭제합니다. 더보기...
 
(void) - addImage:
 이미지 목록에 이미지를 추가합니다. 더보기...
 
(BOOL) - containsKey:
 객체에 지정된 키를 가진 필드가 포함되어 있는지 테스트합니다. 더보기...
 
(NSArray< NSString * > *) - allKeys
 객체에 있는 모든 필드의 키 집합을 반환합니다. 더보기...
 
(nullable id) - objectForKey:
 필드의 값을 읽습니다. 더보기...
 
(void) - setString:forKey:
 문자열 필드에 값을 저장합니다. 더보기...
 
(nullable NSString *) - 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 표현으로 날짜 필드에 값을 저장합니다. 더보기...
 
(nullable NSDate *) - dateForKey:
 날짜의 제한된 ISO-8601 표현에서 날짜 필드의 값을 읽습니다. 더보기...
 
(nullable NSString *) - dateAsStringForKey:
 날짜 필드의 값을 문자열로 읽습니다. 더보기...
 

공개 속성

NSString *const kGCKMetadataKeyCreationDate
 문자열 키: 생성일. 더보기...
 
NSString *const kGCKMetadataKeyReleaseDate
 문자열 키: 출시일. 더보기...
 
NSString *const kGCKMetadataKeyBroadcastDate
 문자열 키: 방송 날짜. 더보기...
 
NSString *const kGCKMetadataKeyTitle
 문자열 키: Title. 더보기...
 
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
 Double 키: 위치의 위도입니다. 더보기...
 
NSString *const kGCKMetadataKeyLocationLongitude
 Double 키: 위치의 경도. 더보기...
 
NSString *const kGCKMetadataKeyBookTitle
 문자열 키: 도서 제목. 더보기...
 
NSString *const kGCKMetadataKeyChapterNumber
 정수 키: 챕터 번호. 더보기...
 
NSString *const kGCKMetadataKeyChapterTitle
 문자열 키: 챕터 제목. 더보기...
 
NSString *const kGCKMetadataKeySectionDuration
 더블 키: 섹션 길이. 더보기...
 
NSString *const kGCKMetadataKeySectionStartTimeInMedia
 더블 키: 미디어의 섹션 시작 시간. 더보기...
 
NSString *const kGCKMetadataKeySectionStartAbsoluteTime
 더블 키: 섹션 절대 시작 시간. 더보기...
 
NSString *const kGCKMetadataKeySectionStartTimeInContainer
 Double 키: 컨테이너의 섹션 시작 시간. 더보기...
 
NSString *const kGCKMetadataKeyQueueItemID
 Double 키: 대기열 항목 ID입니다. 더보기...
 

속성 요약

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

메서드 세부정보

- (instancetype) initWithMetadataType: (GCKMediaMetadataType metadataType

지정된 미디어 유형을 사용하여 비어 있는 새 MediaMetadata를 초기화합니다.

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

Parameters
metadataTypeThe 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
imageThe image to add.
- (BOOL) containsKey: (NSString *)  key

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

Parameters
keyThe key.
반환 값
필드가 있으면 YES, 존재하지 않으면 NO입니다.
- (NSArray<NSString *> *) allKeys

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

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

필드의 값을 읽습니다.

Parameters
keyThe key for the field.
반환 값
필드의 값 또는 필드가 설정되지 않은 경우 nil입니다.
- (void) setString: (NSString *)  value
forKey: (NSString *)  key 

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

Parameters
valueThe new value for the field.
keyThe key for the field.
예외
NSInvalidArgumentException키가 문자열 필드가 아닌 사전 정의된 필드를 참조하는 경우
- (nullable NSString *) stringForKey: (NSString *)  key

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

Parameters
keyThe key for the field.
반환 값
필드의 값 또는 필드가 설정되지 않은 경우 nil입니다.
예외
NSInvalidArgumentException키가 문자열 필드가 아닌 사전 정의된 필드를 참조하는 경우
- (void) setInteger: (NSInteger)  value
forKey: (NSString *)  key 

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

Parameters
valueThe new value for the field.
keyThe key for the field.
예외
NSInvalidArgumentException키가 정수 필드가 아닌 사전 정의된 필드를 참조하는 경우
- (NSInteger) integerForKey: (NSString *)  key

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

Parameters
keyThe key for the field.
반환 값
필드의 값 또는 0(필드가 설정되지 않은 경우)입니다.
예외
NSInvalidArgumentException키가 정수 필드가 아닌 사전 정의된 필드를 참조하는 경우
- (NSInteger) integerForKey: (NSString *)  key
defaultValue: (NSInteger)  defaultValue 

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

Parameters
keyThe key for the field.
defaultValueThe value to return if the field has not been set.
반환 값
필드의 값 또는 필드가 설정되지 않은 경우 지정된 기본값입니다.
예외
NSInvalidArgumentException키가 정수 필드가 아닌 사전 정의된 필드를 참조하는 경우
- (void) setDouble: (double)  value
forKey: (NSString *)  key 

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

Parameters
valueThe new value for the field.
keyThe key for the field.
예외
NSInvalidArgumentException키가 double 필드가 아닌 사전 정의된 필드를 참조하는 경우입니다.
- (double) doubleForKey: (NSString *)  key

double 필드의 값을 읽습니다.

Parameters
keyThe key for the field.
반환 값
필드의 값 또는 0(필드가 설정되지 않은 경우)입니다.
예외
NSInvalidArgumentException키가 double 필드가 아닌 사전 정의된 필드를 참조하는 경우입니다.
- (double) doubleForKey: (NSString *)  key
defaultValue: (double)  defaultValue 

double 필드의 값을 읽습니다.

Parameters
defaultValueThe value to return if the field has not been set.
keyThe key for the field.
반환 값
필드의 값 또는 필드가 설정되지 않은 경우 지정된 기본값입니다.
예외
NSInvalidArgumentException키가 double 필드가 아닌 사전 정의된 필드를 참조하는 경우입니다.
- (void) setDate: (NSDate *)  date
forKey: (NSString *)  key 

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

Parameters
dateThe new value for the field.
keyThe key for the field.
예외
NSInvalidArgumentException키가 날짜 필드가 아닌 사전 정의된 필드를 참조하는 경우
- (nullable NSDate *) dateForKey: (NSString *)  key

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

Parameters
keyThe field name.
반환 값
날짜 또는 nil(필드가 설정되지 않은 경우)
예외
NSInvalidArgumentException키가 날짜 필드가 아닌 사전 정의된 필드를 참조하는 경우
- (nullable NSString *) dateAsStringForKey: (NSString *)  key

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

Parameters
keyThe 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

문자열 키: Title.

미디어의 제목입니다. 예를 들어 노래, 영화 또는 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

Double 키: 위치의 위도입니다.

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

- (NSString* const) kGCKMetadataKeyLocationLongitude

Double 키: 위치의 경도.

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

- (NSString* const) kGCKMetadataKeyBookTitle

문자열 키: 도서 제목.

오디오북의 제목입니다.

다음 이후:
4.3.5
- (NSString* const) kGCKMetadataKeyChapterNumber

정수 키: 챕터 번호.

오디오북의 챕터 번호입니다.

다음 이후:
4.3.5
- (NSString* const) kGCKMetadataKeyChapterTitle

문자열 키: 챕터 제목.

오디오북의 챕터 제목입니다.

다음 이후:
4.3.5
- (NSString* const) kGCKMetadataKeySectionDuration

더블 키: 섹션 길이.

섹션 길이(초)입니다. 큐 메타데이터에 사용됩니다. 예를 들어 대기열에 있는 TV 프로그램 한 편의 길이, 오디오북의 챕터 길이 또는 긴 실시간 스트림의 프로그램이 될 수 있습니다.

다음 이후:
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

더블 키: 미디어의 섹션 시작 시간.

미디어 항목 시작 부분부터 초 단위의 섹션 시작 시간 오프셋입니다. 큐 메타데이터에 사용됩니다.

다음 이후:
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

더블 키: 섹션 절대 시작 시간.

섹션 시작의 절대 시간으로 초 단위의 에포크 시간입니다. 큐 메타데이터에 사용됩니다.

다음 이후:
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

Double 키: 컨테이너의 섹션 시작 시간.

전체 컨테이너 내 섹션 시작 시간의 오프셋입니다. 큐 메타데이터에 사용됩니다.

다음 이후:
4.4.1
- (NSString* const) kGCKMetadataKeyQueueItemID

Double 키: 대기열 항목 ID입니다.

섹션 시작 시간이 포함된 대기열 항목의 ID입니다. 큐 메타데이터에 사용됩니다.

다음 이후:
4.4.1

부동산 세부정보

- (GCKMediaMetadataType) metadataType
readnonatomicassign

메타데이터 유형입니다.