개요
미디어 메타데이터의 컨테이너입니다.
메타데이터에는 미디어 유형, 이미지 목록(선택사항), 메타데이터 필드 모음이 있습니다. 공통 메타데이터 필드의 키는 상수로 사전 정의되어 있지만 애플리케이션은 자체적으로 추가 필드를 자유롭게 정의하고 사용할 수 있습니다.
사전 정의된 필드의 값에는 사전 정의된 유형이 있습니다. 예를 들어 트랙 번호는 NSInteger이고 생성일은 날짜와 시간의 ISO-8601 표현을 포함하는 NSString입니다. 잘못된 유형의 값을 필드에 저장하려고 하면 NSInvalidArgumentException이 발생합니다.
Cast 프로토콜은 특정 미디어 유형에 사용할 수 있는 메타데이터 필드를 제한합니다. Cast 수신기에 전송하기 위해 MediaMetadata 객체를 JSON으로 직렬화하는 경우 특정 미디어 유형에서 지원되지 않는 사전 정의된 필드는 직렬화된 형식에 포함되지 않지만 애플리케이션 정의 필드는 항상 포함됩니다. 사전 정의된 필드의 전체 목록은 다음과 같습니다.
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
-
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 |
객체에 있는 모든 필드의 키 집합을 반환합니다.
| - (nullable id) 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 키가 문자열 필드가 아닌 사전 정의된 필드를 참조하는 경우
| - (nullable NSString *) 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 키가 날짜 필드가 아닌 사전 정의된 필드를 참조하는 경우
| - (nullable NSDate *) dateForKey: | (NSString *) | key |
날짜의 제한된 ISO-8601 표현에서 날짜 필드의 값을 읽습니다.
- Parameters
-
key The field name.
- 반환 값
- 날짜 또는
nil(필드가 설정되지 않은 경우)
- 예외
-
NSInvalidArgumentException 키가 날짜 필드가 아닌 사전 정의된 필드를 참조하는 경우
| - (nullable NSString *) 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 |
문자열 키: 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
부동산 세부정보
|
readnonatomicassign |
메타데이터 유형입니다.