Tổng quan

Vùng chứa siêu dữ liệu nội dung nghe nhìn.

Siêu dữ liệu có một loại nội dung nghe nhìn, một danh sách hình ảnh (không bắt buộc) và một tập hợp các trường siêu dữ liệu. Các khoá cho các trường siêu dữ liệu phổ biến được xác định trước dưới dạng hằng số, nhưng ứng dụng có thể tự do xác định và sử dụng các trường bổ sung của riêng mình.

Các giá trị của trường được xác định trước có các loại được xác định trước. Ví dụ: số bản nhạc là NSInteger và ngày tạo là NSString chứa một giá trị đại diện ISO-8601 cho ngày và giờ. Việc cố gắng lưu trữ một giá trị có loại không chính xác trong một trường sẽ làm phát sinh NSInvalidArgumentException.

Xin lưu ý rằng giao thức truyền nội dung giới hạn những trường siêu dữ liệu có thể dùng cho một loại nội dung nghe nhìn nhất định. Khi một đối tượng MediaMetadata được chuyển đổi tuần tự thành JSON để phân phối đến một bộ nhận Cast, mọi trường được xác định trước không được hỗ trợ cho một loại nội dung nghe nhìn nhất định sẽ không được đưa vào dạng tuần tự hoá, nhưng mọi trường do ứng dụng xác định sẽ luôn được đưa vào. Sau đây là danh sách đầy đủ các trường được xác định trước:

Trường	Loại giá trị	Các loại siêu dữ liệu hợp lệ
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

Kế thừa NSObject. Triển khai <NSCopying>.

Tóm tắt phương thức của thực thể
(instancetype)	- initWithMetadataType:
	Khởi chạy một MediaMetadata mới, trống với loại nội dung nghe nhìn đã cho. Tuỳ chọn khác...

(instancetype)	- init
	Khởi chạy bằng kiểu siêu dữ liệu chung. Tuỳ chọn khác...

(GCKMediaMetadataType)	- metadataType
	Loại siêu dữ liệu. Tuỳ chọn khác...

(NSArray *)	- images
	Lấy danh sách hình ảnh. Tuỳ chọn khác...

(void)	- removeAllMediaImages
	Xoá tất cả hình ảnh hiện tại. Tuỳ chọn khác...

(void)	- addImage:
	Thêm một hình ảnh vào danh sách hình ảnh. Tuỳ chọn khác...

(BOOL)	- containsKey:
	Kiểm thử xem đối tượng có chứa một trường có khoá đã cho hay không. Tuỳ chọn khác...

(NSArray< NSString * > *)	- allKeys
	Trả về một tập hợp khoá cho tất cả các trường có trong đối tượng. Tuỳ chọn khác...

(id __nullable)	- objectForKey:
	Đọc giá trị của một trường. Tuỳ chọn khác...

(void)	- setString:forKey:
	Lưu trữ một giá trị trong trường chuỗi. Tuỳ chọn khác...

(NSString *__nullable)	- stringForKey:
	Đọc giá trị của một trường chuỗi. Tuỳ chọn khác...

(void)	- setInteger:forKey:
	Lưu trữ một giá trị trong trường số nguyên. Tuỳ chọn khác...

(NSInteger)	- integerForKey:
	Đọc giá trị của một trường số nguyên. Tuỳ chọn khác...

(NSInteger)	- integerForKey:defaultValue:
	Đọc giá trị của một trường số nguyên. Tuỳ chọn khác...

(void)	- setDouble:forKey:
	Lưu trữ một giá trị trong trường double. Tuỳ chọn khác...

(double)	- doubleForKey:
	Đọc giá trị của trường double. Tuỳ chọn khác...

(double)	- doubleForKey:defaultValue:
	Đọc giá trị của trường double. Tuỳ chọn khác...

(void)	- setDate:forKey:
	Lưu trữ một giá trị trong trường ngày dưới dạng biểu thị ngày theo chuẩn ISO-8601 bị hạn chế. Tuỳ chọn khác...

(NSDate *__nullable)	- dateForKey:
	Đọc giá trị của một trường ngày từ biểu thị ngày theo chuẩn ISO-8601 bị hạn chế. Tuỳ chọn khác...

(NSString *__nullable)	- dateAsStringForKey:
	Đọc giá trị của một trường ngày, dưới dạng chuỗi. Tuỳ chọn khác...

Thuộc tính công khai
NSString *const	kGCKMetadataKeyCreationDate
	Khoá chuỗi: Ngày tạo. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyReleaseDate
	Khoá chuỗi: Ngày phát hành. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyBroadcastDate
	Khoá chuỗi: Ngày phát sóng. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyTitle
	Khoá chuỗi: Tiêu đề. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeySubtitle
	Khoá chuỗi: Subtitle. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyArtist
	Khoá chuỗi: Nghệ sĩ. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyAlbumArtist
	Khoá chuỗi: Nghệ sĩ của đĩa nhạc. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyAlbumTitle
	Khoá chuỗi: Tên đĩa nhạc. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyComposer
	Khoá chuỗi: Composer. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyDiscNumber
	Khoá số nguyên: Số đĩa. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyTrackNumber
	Khoá số nguyên: Số bản nhạc. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeySeasonNumber
	Khoá số nguyên: Số phần. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyEpisodeNumber
	Khoá số nguyên: Số tập. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeySeriesTitle
	Khoá chuỗi: Tên bộ sách. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyStudio
	Khoá chuỗi: Studio. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyWidth
	Khoá số nguyên: Chiều rộng. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyHeight
	Khoá số nguyên: Chiều cao. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyLocationName
	Khoá chuỗi: Tên vị trí. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyLocationLatitude
	Khoá kép: Vĩ độ vị trí. Tuỳ chọn khác...

NSString *const	kGCKMetadataKeyLocationLongitude
	Khoá kép: Kinh độ vị trí. Tuỳ chọn khác...

Tóm tắt về tài sản
GCKMediaMetadataType	metadataType
	Loại siêu dữ liệu. Tuỳ chọn khác...

Thông tin chi tiết về phương thức

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Khởi chạy một MediaMetadata mới, trống với loại nội dung nghe nhìn đã cho.

Trình khởi tạo được chỉ định.

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

Khởi chạy bằng kiểu siêu dữ liệu chung.

- (GCKMediaMetadataType) metadataType

Loại siêu dữ liệu.

- (NSArray *) images

Lấy danh sách hình ảnh.

- (void) removeAllMediaImages

Xoá tất cả hình ảnh hiện tại.

- (void) addImage: (GCKImage *) image

Thêm một hình ảnh vào danh sách hình ảnh.

Parameters

image The image to add.

- (BOOL) containsKey: (NSString *) key

Kiểm thử xem đối tượng có chứa một trường có khoá đã cho hay không.

Parameters

key The key.

Giá trị trả về: YES nếu trường tồn tại, NO nếu không.

- (NSArray<NSString *> *) allKeys

Trả về một tập hợp khoá cho tất cả các trường có trong đối tượng.

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

Đọc giá trị của một trường.

Parameters

key	The key for the field.

Giá trị trả về: Giá trị của trường hoặc nil nếu trường chưa được đặt.

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

Lưu trữ một giá trị trong trường chuỗi.

Parameters

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

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường chuỗi.

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

Đọc giá trị của một trường chuỗi.

Parameters

key	The key for the field.

Giá trị trả về: Giá trị của trường hoặc nil nếu trường chưa được đặt.

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường chuỗi.

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

Lưu trữ một giá trị trong trường số nguyên.

Parameters

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

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường số nguyên.

- (NSInteger) integerForKey: (NSString *) key

Đọc giá trị của một trường số nguyên.

Parameters

key	The key for the field.

Giá trị trả về: Giá trị của trường hoặc 0 nếu trường chưa được đặt.

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường số nguyên.

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

Đọc giá trị của một trường số nguyên.

Parameters

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

Giá trị trả về: Giá trị của trường hoặc giá trị mặc định đã cho nếu trường chưa được đặt.

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường số nguyên.

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

Lưu trữ một giá trị trong trường double.

Parameters

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

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường double.

- (double) doubleForKey: (NSString *) key

Đọc giá trị của trường double.

Parameters

key	The key for the field.

Giá trị trả về: Giá trị của trường hoặc 0 nếu trường chưa được đặt.

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường double.

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

Đọc giá trị của trường double.

Parameters

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

Giá trị trả về: Giá trị của trường hoặc giá trị mặc định đã cho nếu trường chưa được đặt.

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường double.

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

Lưu trữ một giá trị trong trường ngày dưới dạng biểu thị ngày theo chuẩn ISO-8601 bị hạn chế.

Parameters

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

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường ngày.

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

Đọc giá trị của một trường ngày từ biểu thị ngày theo chuẩn ISO-8601 bị hạn chế.

Parameters

key	The field name.

Giá trị trả về: Ngày hoặc nil nếu bạn chưa đặt trường này.

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường ngày.

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

Đọc giá trị của một trường ngày, dưới dạng chuỗi.

Parameters

key	The field name.

Giá trị trả về: Ngày dưới dạng một chuỗi chứa biểu thị ngày theo ISO-8601 bị hạn chế hoặc nil nếu trường này chưa được đặt.

Ngoại lệ

NSInvalidArgumentException nếu khoá đề cập đến một trường được xác định trước không phải là trường ngày.

Tài liệu về dữ liệu thành viên

- (NSString* const) kGCKMetadataKeyCreationDate

Khoá chuỗi: Ngày tạo.

Giá trị này là ngày và/hoặc giờ mà nội dung nghe nhìn được tạo, ở định dạng ISO-8601. Ví dụ: đây có thể là ngày và giờ chụp ảnh hoặc ghi âm một bản nhạc.

- (NSString* const) kGCKMetadataKeyReleaseDate

Khoá chuỗi: Ngày phát hành.

Giá trị này là ngày và/hoặc giờ phát hành nội dung nghe nhìn, ở định dạng ISO-8601. Ví dụ: đây có thể là ngày phát hành một bộ phim hoặc đĩa nhạc.

- (NSString* const) kGCKMetadataKeyBroadcastDate

Khoá chuỗi: Ngày phát sóng.

Giá trị này là ngày và/hoặc giờ mà nội dung nghe nhìn được phát sóng lần đầu, ở định dạng ISO-8601. Ví dụ: đây có thể là ngày phát sóng tập đầu tiên của một chương trình truyền hình.

- (NSString* const) kGCKMetadataKeyTitle

Khoá chuỗi: Tiêu đề.

Tiêu đề của nội dung nghe nhìn. Ví dụ: đây có thể là tên của một bài hát, bộ phim hoặc tập chương trình truyền hình. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeySubtitle

Khoá chuỗi: Subtitle.

Phụ đề của nội dung nghe nhìn. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyArtist

Khoá chuỗi: Nghệ sĩ.

Tên của nghệ sĩ đã tạo ra nội dung nghe nhìn. Ví dụ: đây có thể là tên của một nhạc sĩ, người biểu diễn hoặc nhiếp ảnh gia. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Khoá chuỗi: Nghệ sĩ của đĩa nhạc.

Tên của nghệ sĩ đã sản xuất một đĩa nhạc. Ví dụ: Trong các đĩa nhạc tuyển tập như bản phối DJ, nghệ sĩ của đĩa nhạc không nhất thiết phải giống với(các) nghệ sĩ của từng bài hát trong đĩa nhạc. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyAlbumTitle

Khoá chuỗi: Tên đĩa nhạc.

Tên đĩa nhạc chứa bản nhạc. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyComposer

Khoá chuỗi: Composer.

Tên của nhà soạn nhạc của một bản nhạc. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyDiscNumber

Khoá số nguyên: Số đĩa.

Số đĩa (tính từ 1) mà một bản nhạc thuộc về trong một đĩa nhạc có nhiều đĩa.

- (NSString* const) kGCKMetadataKeyTrackNumber

Khoá số nguyên: Số bản nhạc.

Số thứ tự của một bản nhạc trong đĩa nhạc. Thông thường, số thứ tự của bản nhạc được tính từ 1, tuy nhiên, giá trị này có thể là 0 nếu đó là một "bản nhạc ẩn" ở đầu một album.

- (NSString* const) kGCKMetadataKeySeasonNumber

Khoá số nguyên: Số phần.

Số phần của một tập chương trình truyền hình. Thông thường, số phần được tính từ 1, tuy nhiên, giá trị này có thể là 0 nếu đó là một tập "thử nghiệm" trước khi một loạt chương trình truyền hình chính thức bắt đầu.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Khoá số nguyên: Số tập.

Số tập trong một phần cụ thể của một chương trình truyền hình. Thông thường, số tập được tính từ 1, tuy nhiên, giá trị này có thể là 0 nếu đó là một tập "thử nghiệm" không được coi là một tập chính thức của phần đầu tiên.

- (NSString* const) kGCKMetadataKeySeriesTitle

Khoá chuỗi: Tên bộ sách.

Tên của một bộ phim/chương trình. Ví dụ: đây có thể là tên của một chương trình truyền hình hoặc một loạt đĩa nhạc có liên quan. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyStudio

Khoá chuỗi: Studio.

Tên của một phòng thu đã sản xuất một tác phẩm truyền thông. Ví dụ: đây có thể là tên của một hãng phim hoặc hãng nhạc. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyWidth

Khoá số nguyên: Chiều rộng.

Chiều rộng của một phần nội dung nghe nhìn, tính bằng pixel. Thông thường, bạn sẽ dùng thuộc tính này để cung cấp kích thước của một bức ảnh.

- (NSString* const) kGCKMetadataKeyHeight

Khoá số nguyên: Chiều cao.

Chiều cao của một phần nội dung nghe nhìn, tính bằng pixel. Thông thường, bạn sẽ dùng thuộc tính này để cung cấp kích thước của một bức ảnh.

- (NSString* const) kGCKMetadataKeyLocationName

Khoá chuỗi: Tên vị trí.

Tên của một địa điểm nơi nội dung nghe nhìn được tạo. Ví dụ: đây có thể là vị trí chụp ảnh hoặc vị trí quay phim chính của một bộ phim. Giá trị này phù hợp cho mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyLocationLatitude

Khoá kép: Vĩ độ vị trí.

Thành phần vĩ độ của vị trí địa lý nơi một phần nội dung nghe nhìn được tạo. Ví dụ: đây có thể là vị trí chụp ảnh hoặc vị trí quay phim chính của một bộ phim.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Khoá kép: Kinh độ vị trí.

Thành phần kinh độ của vị trí địa lý nơi một nội dung nghe nhìn được tạo. Ví dụ: đây có thể là vị trí chụp ảnh hoặc vị trí quay phim chính của một bộ phim.

Thông tin chi tiết về cơ sở lưu trú

- (GCKMediaMetadataType) metadataType

readnonatomicassign

Loại siêu dữ liệu.

Lớp GCKMediaMetadata Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tổng quan

Tóm tắt phương thức của thực thể

Thuộc tính công khai

Tóm tắt về tài sản

Thông tin chi tiết về phương thức

Tài liệu về dữ liệu thành viên

Thông tin chi tiết về cơ sở lưu trú

Lớp GCKMediaMetadata