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 phương tiện, danh sách hình ảnh tùy chọn và một tập hợp các trường siêu dữ liệu. 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 tự do xác định và sử dụng các trường bổ sung của riêng nó.

Giá trị của các trường xác định trước có loại thông tin xác định trước. Ví dụ: số theo dõi là NSInteger và ngày tạo là NSString chứa nội dung đại diện cho ngày và giờ theo định dạng ISO-8601. Việc cố gắng lưu trữ giá trị thuộc loại không chính xác trong một trường sẽ làm tăng NSInvalidArgumentException.

Lưu ý: Giao thức Truyền 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 đa phương tiệ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 broadcast receiver, mọi trường xác định trước không được hỗ trợ cho một loại nội dung đa phương tiện nhất định sẽ không được đưa vào biểu mẫu tuần tự, nhưng mọi trường do ứng dụng xác định sẽ luôn được đưa vào. Danh sách đầy đủ các trường được xác định trước như sau:

Trường	Loại giá trị	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	đôi	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	đôi	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 MediaMetadata mới, trống và có loại phương tiện đã cho. Thêm...

(instancetype)	- init
	Khởi tạo bằng loại siêu dữ liệu chung. Thêm...

(GCKMediaMetadataType)	- metadataType
	Loại siêu dữ liệu. Thêm...

(NSArray *)	- images
	Xem danh sách hình ảnh. Thêm...

(void)	- removeAllMediaImages
	Loại bỏ tất cả hình ảnh hiện tại. Thêm...

(void)	- addImage:
	Thêm một hình ảnh vào danh sách hình ảnh. Thêm...

(BOOL)	- containsKey:
	Kiểm tra xem đối tượng có chứa một trường bằng khoá cho trước hay không. Thêm...

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

(id __nullable)	- objectForKey:
	Đọc giá trị của một trường. Thêm...

(void)	- setString:forKey:
	Lưu trữ một giá trị trong trường chuỗi. Thêm...

(NSString *__nullable)	- stringForKey:
	Đọc giá trị của một trường chuỗi. Thêm...

(void)	- setInteger:forKey:
	Lưu trữ giá trị trong trường số nguyên. Thêm...

(NSInteger)	- integerForKey:
	Đọc giá trị của trường số nguyên. Thêm...

(NSInteger)	- integerForKey:defaultValue:
	Đọc giá trị của trường số nguyên. Thêm...

(void)	- setDouble:forKey:
	Lưu trữ giá trị trong trường double. Thêm...

(double)	- doubleForKey:
	Đọc giá trị của trường double. Thêm...

(double)	- doubleForKey:defaultValue:
	Đọc giá trị của trường double. Thêm...

(void)	- setDate:forKey:
	Lưu trữ một giá trị trong trường ngày dưới dạng đại diện theo ngày ISO-8601 bị hạn chế. Thêm...

(NSDate *__nullable)	- dateForKey:
	Đọc giá trị của trường ngày trong nội dung biểu diễn ngày ISO-8601 bị hạn chế. Thêm...

(NSString *__nullable)	- dateAsStringForKey:
	Đọc giá trị của trường ngày dưới dạng chuỗi. Thêm...

Thuộc tính công khai
NSString *const	kGCKMetadataKeyCreationDate
	Khoá chuỗi: Ngày tạo. Thêm...

NSString *const	kGCKMetadataKeyReleaseDate
	Khoá chuỗi: Ngày phát hành. Thêm...

NSString *const	kGCKMetadataKeyBroadcastDate
	Khoá chuỗi: Ngày phát sóng. Thêm...

NSString *const	kGCKMetadataKeyTitle
	Khoá chuỗi: Tiêu đề. Thêm...

NSString *const	kGCKMetadataKeySubtitle
	Khoá chuỗi: Phụ đề. Thêm...

NSString *const	kGCKMetadataKeyArtist
	Khoá chuỗi: Nghệ sĩ. Thêm...

NSString *const	kGCKMetadataKeyAlbumArtist
	Phím chuỗi: Nghệ sĩ của album. Thêm...

NSString *const	kGCKMetadataKeyAlbumTitle
	Khóa chuỗi: Tiêu đề album. Thêm...

NSString *const	kGCKMetadataKeyComposer
	Khoá chuỗi: Composer. Thêm...

NSString *const	kGCKMetadataKeyDiscNumber
	Khóa số nguyên: Số đĩa. Thêm...

NSString *const	kGCKMetadataKeyTrackNumber
	Khóa số nguyên: Số theo dõi. Thêm...

NSString *const	kGCKMetadataKeySeasonNumber
	Khóa số nguyên: Số phần. Thêm...

NSString *const	kGCKMetadataKeyEpisodeNumber
	Khóa số nguyên: Số tập. Thêm...

NSString *const	kGCKMetadataKeySeriesTitle
	Khoá chuỗi: Tiêu đề chuỗi. Thêm...

NSString *const	kGCKMetadataKeyStudio
	Khoá chuỗi: Studio. Thêm...

NSString *const	kGCKMetadataKeyWidth
	Khóa số nguyên: Chiều rộng. Thêm...

NSString *const	kGCKMetadataKeyHeight
	Khóa số nguyên: Chiều cao. Thêm...

NSString *const	kGCKMetadataKeyLocationName
	Khoá chuỗi: Tên vị trí. Thêm...

NSString *const	kGCKMetadataKeyLocationLatitude
	Khóa kép: Vĩ độ vị trí. Thêm...

NSString *const	kGCKMetadataKeyLocationLongitude
	Khóa kép: Kinh độ của vị trí. Thêm...

Tóm tắt thuộc tính
GCKMediaMetadataType	metadataType
	Loại siêu dữ liệu. Thêm...

Chi tiết phương thức

- (instancetype) initWithMetadataType: (GCKMediaMetadataType) metadataType

Khởi chạy MediaMetadata mới, trống và có loại phương tiệ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 tạo bằng loại siêu dữ liệu chung.

- (GCKMediaMetadataType) metadataType

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

- (NSArray *) images

Xem danh sách hình ảnh.

- (void) removeAllMediaImages

Loại bỏ 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 tra xem đối tượng có chứa một trường bằng khoá cho trước hay không.

Parameters

key The key.

Trả về: YES nếu có trường này, nếu không thì NO.

- (NSArray<NSString *> *) allKeys

Trả về một tập hợp các 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.

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ệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề 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.

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

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề 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ữ 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ệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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 trường số nguyên.

Parameters

key	The key for the field.

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

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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 trường số nguyên.

Parameters

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

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

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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ữ giá trị trong trường double.

Parameters

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

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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.

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

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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.

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

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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 đại diện theo ngày ISO-8601 bị hạn chế.

Parameters

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

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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 trường ngày trong nội dung biểu diễn ngày ISO-8601 bị hạn chế.

Parameters

key	The field name.

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

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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 trường ngày dưới dạng chuỗi.

Parameters

key	The field name.

Trả về: Ngày dưới dạng một chuỗi chứa đại diện ngày theo chuẩn ISO-8601 hoặc nil nếu trường này chưa được đặt.

Ngoại lệ

Trường hợp ngoại lệ NSInvalidArgument nếu khóa đề cập đến 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ị là ngày và/hoặc thời điểm tạo phương tiện, ở định dạng ISO-8601. Ví dụ: Đây có thể là ngày và giờ chụp ảnh hoặc một bản nhạc.

- (NSString* const) kGCKMetadataKeyReleaseDate

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

Giá trị là ngày và/hoặc thời điểm phát hành phương tiện, ở định dạng ISO-8601. Ví dụ: ngày này có thể là ngày phát hành phim hoặc album nhạc.

- (NSString* const) kGCKMetadataKeyBroadcastDate

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

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

- (NSString* const) kGCKMetadataKeyTitle

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

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

- (NSString* const) kGCKMetadataKeySubtitle

Khoá chuỗi: Phụ đề.

Phụ đề của nội dung nghe nhìn. Giá trị này phù hợp với 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ĩ, nghệ sĩ biểu diễn hoặc nhiếp ảnh gia. Giá trị này phù hợp với mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyAlbumArtist

Phím chuỗi: Nghệ sĩ của album.

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

- (NSString* const) kGCKMetadataKeyAlbumTitle

Khóa chuỗi: Tiêu đề album.

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

- (NSString* const) kGCKMetadataKeyComposer

Khoá chuỗi: Composer.

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

- (NSString* const) kGCKMetadataKeyDiscNumber

Khóa số nguyên: Số đĩa.

Số đĩa (đếm từ 1) của một bản nhạc trong đĩa nhạc nhiều đĩa.

- (NSString* const) kGCKMetadataKeyTrackNumber

Khóa số nguyên: Số theo dõi.

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

- (NSString* const) kGCKMetadataKeySeasonNumber

Khóa 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ố thứ tự của phần sẽ được tính bắt đầu từ 1. Tuy nhiên, giá trị này có thể là 0 nếu tập đó là "tập" thử nghiệm trước khi bắt đầu chính thức loạt phim truyền hình.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

Khóa 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 sẽ được tính bắt đầu từ 1. Tuy nhiên, giá trị này có thể là 0 nếu đó là tập "pilot" không được coi là tập chính thức của phần đầu tiên.

- (NSString* const) kGCKMetadataKeySeriesTitle

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

Tên của một bộ sách. 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 các album nhạc có liên quan. Giá trị này phù hợp với mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyStudio

Khoá chuỗi: Studio.

Tên của một phòng thu âm đã sản xuất một phần nội dung đa phương tiện. 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 với mục đích hiển thị.

- (NSString* const) kGCKMetadataKeyWidth

Khóa 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. Tệp này thường được dùng để cung cấp kích thước của ảnh.

- (NSString* const) kGCKMetadataKeyHeight

Khóa 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. Tệp này thường được dùng để cung cấp kích thước của ảnh.

- (NSString* const) kGCKMetadataKeyLocationName

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

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

- (NSString* const) kGCKMetadataKeyLocationLatitude

Khóa 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 đa phương tiện đã được tạo. Ví dụ: Đây có thể là vị trí của một bức ảnh hoặc địa điểm quay phim chính của một bộ phim.

- (NSString* const) kGCKMetadataKeyLocationLongitude

Khóa kép: Kinh độ của vị trí.

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

Chi tiết thuộc tính

- (GCKMediaMetadataType) metadataType

readnonatomicassign

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

Lớp GCKMediaMetadata

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 thuộc tính

Chi tiết phương thức

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

Chi tiết thuộc tính