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 GCKMediaMetadataTypeMovie GCKMediaMetadataTypeGeneric
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복사> 및 <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
 문자열 키: 제목 더보기...
 
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 key: 위치 위도 더보기...
 
NSString *const kGCKMetadataKeyLocationLongitude
 Double key: 위치 경도 더보기...
 
NSString *const kGCKMetadataKeyBookTitle
 문자열 키: 책 제목입니다. 더보기...
 
NSString *const kGCKMetadataKeyChapterNumber
 정수 키: 챕터 번호입니다. 더보기...
 
NSString *const kGCKMetadataKeyChapterTitle
 문자열 키: 챕터 제목입니다. 더보기...
 
NSString *const kGCKMetadataKeySectionDuration
 Double key: 섹션 길이 더보기...
 
NSString *const kGCKMetadataKeySectionStartTimeInMedia
 더블 키: 미디어의 섹션 시작 시간 더보기...
 
NSString *const kGCKMetadataKeySectionStartAbsoluteTime
 Double key: 섹션 절대 시작 시간 더보기...
 
NSString *const kGCKMetadataKeySectionStartTimeInContainer
 Double key: 컨테이너의 섹션 시작 시간 더보기...
 
NSString *const kGCKMetadataKeyQueueItemID
 Double key: 큐 항목 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

문자열 키: 제목

미디어의 제목입니다. 예를 들어 노래, 영화, 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 key: 위치 위도

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

- (NSString* const) kGCKMetadataKeyLocationLongitude

Double key: 위치 경도

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

- (NSString* const) kGCKMetadataKeyBookTitle

문자열 키: 책 제목입니다.

오디오북 제목

Since
4.3.5
- (NSString* const) kGCKMetadataKeyChapterNumber

정수 키: 챕터 번호입니다.

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

Since
4.3.5
- (NSString* const) kGCKMetadataKeyChapterTitle

문자열 키: 챕터 제목입니다.

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

Since
4.3.5
- (NSString* const) kGCKMetadataKeySectionDuration

Double key: 섹션 길이

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

Since
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

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

미디어 항목의 시작 부분으로부터의 시간(초)에 대한 오프셋입니다. 큐 메타데이터에 사용됩니다.

Since
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

Double key: 섹션 절대 시작 시간

섹션 시작의 절대 시간(에포크 시간, 초)입니다. 큐 메타데이터에 사용됩니다.

Since
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

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

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

Since
4.4.1
- (NSString* const) kGCKMetadataKeyQueueItemID

Double key: 큐 항목 ID

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

Since
4.4.1

부동산 세부정보

- (GCKMediaMetadataType) metadataType
readnonatomicassign

메타데이터 유형입니다.