개요
미디어 메타데이터의 컨테이너.
메타데이터에는 미디어 유형, 선택적 이미지 목록, 메타데이터 필드 컬렉션이 있습니다. 공통 메타데이터 필드의 키는 상수로 사전 정의되어 있지만 애플리케이션에서 자유롭게 추가 필드를 자유롭게 정의하고 사용할 수 있습니다.
사전 정의된 필드의 값에는 사전 정의된 유형이 있습니다. 예를 들어 트랙 번호는 NSInteger
이고 생성 날짜는 날짜 및 시간의 ISO-8601 표현을 포함하는 NSString입니다. 필드에 잘못된 유형의 값을 저장하려고 하면 NSInvalidArgumentException이 발생합니다.
Cast 프로토콜은 특정 미디어 유형에 사용할 수 있는 메타데이터 필드를 제한합니다. Cast 수신기로 전송하기 위해 MediaMetadata 객체를 JSON으로 직렬화하는 경우, 지정된 미디어 유형에서 지원되지 않는 사전 정의된 필드는 직렬화된 양식에 포함되지 않지만 모든 애플리케이션 정의 필드는 포함됩니다. 사전 정의된 필드의 전체 목록은 다음과 같습니다.
NSObject를 상속합니다. <NS복사>를 구현합니다.
인스턴스 메서드 요약 | |
(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 |
Double key: 위치 위도 더보기... | |
NSString *const | kGCKMetadataKeyLocationLongitude |
Double key: 위치 경도 더보기... | |
속성 요약 | |
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 |
Double key: 위치 위도
미디어가 생성된 지리적 위치의 위도 구성요소입니다. 예를 들어 사진의 위치 또는 영화의 주요 촬영 위치일 수 있습니다.
- (NSString* const) kGCKMetadataKeyLocationLongitude |
Double key: 위치 경도
미디어가 생성된 지리적 위치의 경도 구성요소입니다. 예를 들어 사진의 위치 또는 영화의 주요 촬영 위치일 수 있습니다.
부동산 세부정보
|
readnonatomicassign |
메타데이터 유형입니다.