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

مرجع کلاس GCKMediaMetadata

بررسی اجمالی

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

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

مقادیر فیلدهای از پیش تعریف شده دارای انواع از پیش تعریف شده هستند. به عنوان مثال، یک شماره آهنگ یک 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> و <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) - doubleForKey:
مقدار یک فیلد دوتایی را می خواند. بیشتر...
(double) - doubleForKey:defaultValue:
مقدار یک فیلد دوتایی را می خواند. بیشتر...
(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
کلید رشته: عنوان. بیشتر...
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
کلید دوگانه: طول جغرافیایی مکان. بیشتر...
NSString *const  kGCKMetadataKeyBookTitle
کلید رشته: عنوان کتاب. بیشتر...
NSString *const  kGCKMetadataKeyChapterNumber
کلید عدد صحیح: شماره فصل. بیشتر...
NSString *const  kGCKMetadataKeyChapterTitle
کلید رشته: عنوان فصل. بیشتر...
NSString *const  kGCKMetadataKeySectionDuration
دو کلید: مدت زمان بخش. بیشتر...
NSString *const  kGCKMetadataKeySectionStartTimeInMedia
کلید دوگانه: بخش زمان شروع در رسانه. بیشتر...
NSString *const  kGCKMetadataKeySectionStartAbsoluteTime
کلید دوگانه: بخش زمان شروع مطلق. بیشتر...
NSString *const  kGCKMetadataKeySectionStartTimeInContainer
کلید دوگانه: بخش زمان شروع در کانتینر. بیشتر...
NSString *const  kGCKMetadataKeyQueueItemID
کلید دوگانه: شناسه مورد صف. بیشتر...

خلاصه اموال

GCKMediaMetadataType   metadataType
نوع ابرداده بیشتر...

جزئیات روش

- (instancetype) initWithMetadataType: ( GCKMediaMetadataType metadataType

یک MediaMetadata جدید و خالی را با نوع رسانه داده شده راه اندازی می کند.

مقداردهی اولیه تعیین شده

Parameters
metadataTypeThe 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
imageThe image to add.
- (BOOL) containsKey: (NSString *)  key

آزمایش می کند که آیا شی دارای فیلدی با کلید داده شده است یا خیر.

Parameters
keyThe key.
برمی گرداند
در صورت وجود فیلد YES ، در غیر این صورت NO .
- (NSArray<NSString *> *) allKeys

مجموعه ای از کلیدها را برای تمام فیلدهایی که در شیء موجود هستند برمی گرداند.

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

ارزش یک فیلد را می خواند.

Parameters
keyThe key for the field.
برمی گرداند
مقدار فیلد، یا اگر فیلد تنظیم نشده باشد، nil .
- (void) setString: (NSString *)  value
forKey: (NSString *)  key  

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

Parameters
valueThe new value for the field.
keyThe key for the field.
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که فیلد رشته ای نیست.
- (nullable NSString *) stringForKey: (NSString *)  key

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

Parameters
keyThe key for the field.
برمی گرداند
مقدار فیلد، یا اگر فیلد تنظیم نشده باشد، nil .
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که فیلد رشته ای نیست.
- (void) setInteger: (NSInteger)  value
forKey: (NSString *)  key  

یک مقدار را در یک فیلد عدد صحیح ذخیره می کند.

Parameters
valueThe new value for the field.
keyThe key for the field.
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد عدد صحیح نیست.
- (NSInteger) integerForKey: (NSString *)  key

مقدار یک فیلد عدد صحیح را می خواند.

Parameters
keyThe key for the field.
برمی گرداند
مقدار فیلد یا 0 اگر فیلد تنظیم نشده باشد.
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد عدد صحیح نیست.
- (NSInteger) integerForKey: (NSString *)  key
defaultValue: (NSInteger)  defaultValue  

مقدار یک فیلد عدد صحیح را می خواند.

Parameters
keyThe key for the field.
defaultValueThe value to return if the field has not been set.
برمی گرداند
مقدار فیلد یا مقدار پیش‌فرض داده شده در صورتی که فیلد تنظیم نشده باشد.
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد عدد صحیح نیست.
- (void) setDouble: (double)  value
forKey: (NSString *)  key  

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

Parameters
valueThe new value for the field.
keyThe key for the field.
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد دوتایی نیست.
- (double) doubleForKey: (NSString *)  key

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

Parameters
keyThe key for the field.
برمی گرداند
مقدار فیلد یا 0 اگر فیلد تنظیم نشده باشد.
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد دوتایی نیست.
- (double) doubleForKey: (NSString *)  key
defaultValue: (double)  defaultValue  

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

Parameters
defaultValueThe value to return if the field has not been set.
keyThe key for the field.
برمی گرداند
مقدار فیلد یا مقدار پیش‌فرض داده شده در صورتی که فیلد تنظیم نشده باشد.
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که یک فیلد دوتایی نیست.
- (void) setDate: (NSDate *)  date
forKey: (NSString *)  key  

مقداری را در فیلد تاریخ به عنوان یک نمایش ISO-8601 محدود از تاریخ ذخیره می کند.

Parameters
dateThe new value for the field.
keyThe key for the field.
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که فیلد تاریخ نیست.
- (nullable NSDate *) dateForKey: (NSString *)  key

مقدار یک فیلد تاریخ را از بازنمایی محدود ISO-8601 تاریخ می خواند.

Parameters
keyThe field name.
برمی گرداند
تاریخ، یا اگر این فیلد تنظیم نشده باشد، nil .
استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که فیلد تاریخ نیست.
- (nullable NSString *) dateAsStringForKey: (NSString *)  key

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

Parameters
keyThe 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

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

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

- (NSString* const) kGCKMetadataKeyBookTitle

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

عنوان یک کتاب صوتی.

از آنجا که
4.3.5
- (NSString* const) kGCKMetadataKeyChapterNumber

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

تعداد یک فصل در یک کتاب صوتی.

از آنجا که
4.3.5
- (NSString* const) kGCKMetadataKeyChapterTitle

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

عنوان فصلی از یک کتاب صوتی.

از آنجا که
4.3.5
- (NSString* const) kGCKMetadataKeySectionDuration

کلید دوگانه: مدت زمان بخش.

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

از آنجا که
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInMedia

کلید دوگانه: بخش زمان شروع در رسانه.

افست زمان شروع بخش از شروع آیتم رسانه بر حسب ثانیه. برای ابرداده های صف استفاده می شود.

از آنجا که
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartAbsoluteTime

کلید دوگانه: بخش زمان شروع مطلق.

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

از آنجا که
4.4.1
- (NSString* const) kGCKMetadataKeySectionStartTimeInContainer

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

افست زمان شروع بخش در ظرف کامل. برای ابرداده های صف استفاده می شود.

از آنجا که
4.4.1
- (NSString* const) kGCKMetadataKeyQueueItemID

کلید دوگانه: شناسه مورد صف.

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

از آنجا که
4.4.1

جزئیات ملک

- ( GCKMediaMetadataType ) metadataType
read nonatomic assign

نوع ابرداده