بررسی اجمالی
ظرفی برای فراداده رسانه.
فراداده دارای یک نوع رسانه، یک لیست اختیاری از تصاویر و مجموعه ای از فیلدهای فراداده است. کلیدهای فیلدهای فراداده رایج به صورت ثابت از پیش تعریف شده اند، اما برنامه در تعریف و استفاده از فیلدهای اضافی خود آزاد است.
مقادیر فیلدهای از پیش تعریف شده دارای انواع از پیش تعریف شده هستند. به عنوان مثال، یک شماره آهنگ یک NSInteger
و یک تاریخ ایجاد یک NSString است که حاوی یک نمایش ISO-8601 از تاریخ و زمان است. تلاش برای ذخیره مقداری از نوع نادرست در یک فیلد، یک NSInvalidArgumentException ایجاد می کند.
توجه داشته باشید که پروتکل Cast محدود می کند که کدام فیلدهای فراداده را می توان برای یک نوع رسانه خاص استفاده کرد. وقتی یک شی MediaMetadata برای تحویل به گیرنده Cast به JSON سریال میشود، هر فیلد از پیش تعریفشدهای که برای یک نوع رسانه خاص پشتیبانی نمیشود، در فرم سریالی گنجانده نمیشود، اما فیلدهای تعریفشده توسط برنامه همیشه گنجانده میشوند. لیست کامل فیلدهای از پیش تعریف شده به شرح زیر است:
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
-
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 |
مجموعه ای از کلیدها را برای تمام فیلدهایی که در شیء موجود هستند برمی گرداند.
- (nullable id) 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 اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که فیلد رشته ای نیست.
- (nullable NSString *) 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 اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که فیلد تاریخ نیست.
- (nullable NSDate *) dateForKey: | (NSString *) | key |
مقدار یک فیلد تاریخ را از بازنمایی محدود ISO-8601 تاریخ می خواند.
- Parameters
-
key The field name.
- برمی گرداند
- تاریخ، یا اگر این فیلد تنظیم نشده باشد،
nil
.
- استثناها
NSInvalidArgumentException اگر کلید به یک فیلد از پیش تعریف شده اشاره دارد که فیلد تاریخ نیست.
- (nullable NSString *) 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 |
کلید دوگانه: طول جغرافیایی مکان.
مولفه طول جغرافیایی موقعیت جغرافیایی که یک قطعه رسانه در آن ایجاد شده است. به عنوان مثال، این می تواند محل یک عکس یا محل فیلمبرداری اصلی یک فیلم باشد.
- (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
جزئیات ملک
|
read nonatomic assign |
نوع ابرداده