نمای کلی

ظرفی برای فراداده رسانه.

فراداده دارای یک نوع رسانه، یک لیست اختیاری از تصاویر و مجموعه ای از فیلدهای فراداده است. کلیدهای فیلدهای فراداده رایج به صورت ثابت از پیش تعریف شده اند، اما برنامه در تعریف و استفاده از فیلدهای اضافی خود آزاد است.

مقادیر فیلدهای از پیش تعریف شده دارای انواع از پیش تعریف شده هستند. به عنوان مثال، یک شماره آهنگ یک NSInteger و یک تاریخ ایجاد یک NSString است که حاوی یک نمایش ISO-8601 از تاریخ و زمان است. تلاش برای ذخیره مقداری از نوع نادرست در یک فیلد، یک NSInvalidArgumentException ایجاد می کند.

توجه داشته باشید که پروتکل Cast محدود می کند که کدام فیلدهای فراداده را می توان برای یک نوع رسانه خاص استفاده کرد. وقتی یک شی MediaMetadata برای تحویل به گیرنده Cast به JSON سریال می‌شود، هر فیلد از پیش تعریف‌شده‌ای که برای یک نوع رسانه خاص پشتیبانی نمی‌شود، در فرم سریالی گنجانده نمی‌شود، اما فیلدهای تعریف‌شده توسط برنامه همیشه گنجانده می‌شوند. لیست کامل فیلدهای از پیش تعریف شده به شرح زیر است:

میدان	نوع ارزش	انواع متادیتا معتبر
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	دو برابر کردن	GCKMediaMetadataTypePhoto
kGCKMetadataKeyLocationLongitude	دو برابر کردن	GCKMediaMetadataTypePhoto

NSObject را به ارث می برد. <NSCopying> را پیاده سازی می کند.

خلاصه روش نمونه
(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)	- doubleForKey:
	مقدار یک فیلد دوگانه را می خواند. بیشتر...

(double)	- doubleForKey:defaultValue:
	مقدار یک فیلد دوگانه را می خواند. بیشتر...

(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
	کلید رشته: آهنگساز. بیشتر...

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
	کلید دوگانه: عرض جغرافیایی مکان. بیشتر...

NSString *const	kGCKMetadataKeyLocationLongitude
	کلید دوگانه: طول جغرافیایی مکان. بیشتر...

خلاصه اموال
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

یک مقدار را در یک فیلد دوتایی ذخیره می کند.

Parameters

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

استثنائات

NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد دوتایی نیست.

- (double) doubleForKey: (NSString *) key

مقدار یک فیلد دوگانه را می خواند.

Parameters

key	The key for the field.

برمی گرداند: مقدار فیلد یا 0 اگر فیلد تنظیم نشده باشد.

استثنائات

NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد دوتایی نیست.

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

مقدار یک فیلد دوگانه را می خواند.

Parameters

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

برمی گرداند: مقدار فیلد یا مقدار پیش‌فرض داده شده در صورتی که فیلد تنظیم نشده باشد.

استثنائات

NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد دوتایی نیست.

- (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 پخش شد. به عنوان مثال، این می تواند تاریخی باشد که اولین قسمت یک برنامه تلویزیونی پخش شد.

- (NSString* const) kGCKMetadataKeyTitle

کلید رشته: عنوان.

عنوان رسانه. به عنوان مثال، این می تواند عنوان یک آهنگ، فیلم یا قسمت برنامه تلویزیونی باشد. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeySubtitle

کلید رشته: زیرنویس.

زیرنویس رسانه. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeyArtist

کلید رشته: هنرمند.

نام هنرمند سازنده رسانه. به عنوان مثال، این می تواند نام یک نوازنده، مجری یا عکاس باشد. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeyAlbumArtist

کلید رشته: هنرمند آلبوم.

نام هنرمندی که آلبوم تولید کرده است. به عنوان مثال، در آلبوم‌های تلفیقی مانند میکس‌های دی‌جی، هنرمند آلبوم لزوماً با هنرمند(های) تک تک آهنگ‌های آلبوم یکسان نیست. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeyAlbumTitle

کلید رشته: عنوان آلبوم.

عنوان آلبومی که یک قطعه موسیقی به آن تعلق دارد. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeyComposer

کلید رشته: آهنگساز.

نام آهنگساز یک قطعه موسیقی. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeyDiscNumber

کلید عدد صحیح: شماره دیسک.

شماره دیسک (با شمارش از 1) که یک آهنگ موسیقی در یک آلبوم چند دیسکی به آن تعلق دارد.

- (NSString* const) kGCKMetadataKeyTrackNumber

کلید عدد صحیح: شماره آهنگ.

شماره تراک یک آهنگ موسیقی روی دیسک آلبوم. معمولاً شماره‌های آهنگ از ۱ شمرده می‌شوند، اما اگر یک «تراک مخفی» در ابتدای آلبوم باشد، این مقدار ممکن است ۰ باشد.

- (NSString* const) kGCKMetadataKeySeasonNumber

کلید عدد صحیح: شماره فصل.

شماره فصلی که یک قسمت برنامه تلویزیونی به آن تعلق دارد. معمولاً شماره‌های فصل با شروع از 1 شمارش می‌شوند، اما اگر یک قسمت "پایلوت" باشد که قبل از شروع رسمی یک سریال تلویزیونی باشد، این مقدار ممکن است 0 باشد.

- (NSString* const) kGCKMetadataKeyEpisodeNumber

کلید عدد صحیح: شماره قسمت.

تعداد یک قسمت در یک فصل معین از یک برنامه تلویزیونی. معمولاً اعداد قسمت‌ها از 1 شمارش می‌شوند، اما این مقدار ممکن است 0 باشد اگر یک قسمت "پایلوت" باشد که به عنوان قسمت رسمی فصل اول در نظر گرفته نشود.

- (NSString* const) kGCKMetadataKeySeriesTitle

کلید رشته: عنوان سری.

نام یک سریال به عنوان مثال، این می تواند نام یک برنامه تلویزیونی یا مجموعه ای از آلبوم های موسیقی مرتبط باشد. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeyStudio

کلید رشته: Studio.

نام یک استودیو ضبط که یک قطعه رسانه تولید می کرد. به عنوان مثال، این می تواند نام یک استودیو فیلم یا برچسب موسیقی باشد. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeyWidth

کلید عدد صحیح: عرض.

عرض یک قطعه رسانه، بر حسب پیکسل. این معمولاً برای ارائه ابعاد یک عکس استفاده می شود.

- (NSString* const) kGCKMetadataKeyHeight

کلید عدد صحیح: ارتفاع

ارتفاع یک قطعه رسانه، بر حسب پیکسل. این معمولاً برای ارائه ابعاد یک عکس استفاده می شود.

- (NSString* const) kGCKMetadataKeyLocationName

کلید رشته: نام مکان.

نام مکانی که در آن یک قطعه رسانه ایجاد شده است. به عنوان مثال، این می تواند محل یک عکس یا محل فیلمبرداری اصلی یک فیلم باشد. این مقدار برای اهداف نمایش مناسب است.

- (NSString* const) kGCKMetadataKeyLocationLatitude

کلید دوگانه: عرض جغرافیایی مکان.

جزء عرض جغرافیایی مکان جغرافیایی که یک قطعه رسانه در آن ایجاد شده است. به عنوان مثال، این می تواند محل یک عکس یا محل فیلمبرداری اصلی یک فیلم باشد.

- (NSString* const) kGCKMetadataKeyLocationLongitude

کلید دوگانه: طول جغرافیایی مکان.

مولفه طول جغرافیایی موقعیت جغرافیایی که یک قطعه رسانه در آن ایجاد شده است. به عنوان مثال، این می تواند محل یک عکس یا محل فیلمبرداری اصلی یک فیلم باشد.

جزئیات ملک

- ( GCKMediaMetadataType ) metadataType

read nonatomic assign

نوع ابرداده

کلاس متادیتا GCKMedia

نمای کلی

خلاصه روش نمونه

ویژگی های عمومی

خلاصه اموال

جزئیات روش

اسناد داده های اعضا

جزئیات ملک