بررسی اجمالی
کلاسی که جلسه Cast را با دستگاه گیرنده مدیریت می کند.
جلسات به طور خودکار توسط GCKSessionManager ایجاد و مدیریت می شوند. برنامه نباید مستقیماً متدهای چرخه حیات جلسه مانند start (GCKSession(Protected)) یا endWithAction: (GCKSession(Protected)) را فراخوانی کند.
- از آنجا که
- 3.0
GCKSession به ارث می برد.
خلاصه روش نمونه | |
(instancetype) | - initWithDevice:sessionID:sessionOptions:castOptions: |
یک جلسه Cast جدید با گزینههای Cast میسازد. بیشتر... | |
(BOOL) | - addChannel: |
کانالی را با جلسه ثبت می کند. بیشتر... | |
(BOOL) | - removeChannel: |
کانالی که قبلا ثبت نام کرده اید را از جلسه حذف می کند. بیشتر... | |
(void) | - addDeviceStatusListener: |
یک GCKCastDeviceStatusListener را به لیست شنوندگان این شی اضافه می کند. بیشتر... | |
(void) | - removeDeviceStatusListener: |
یک GCKCastDeviceStatusListener را از لیست شنوندگان این شی حذف می کند. بیشتر... | |
( GCKRequest *) | - setDeviceVolume:forMultizoneDevice: |
میزان صدای هر دستگاه را در یک گروه چند منطقه ای تنظیم می کند. بیشتر... | |
( GCKRequest *) | - setDeviceMuted:forMultizoneDevice: |
حالت بیصدا دستگاه را در یک گروه چند منطقهای تنظیم میکند. بیشتر... | |
( GCKRequest *) | - requestMultizoneStatus |
درخواست وضعیت چند منطقه ای از یک گروه چند منطقه ای. بیشتر... | |
(instancetype) | - initWithDevice:traits:sessionID: |
یک شی جلسه جدید را برای دستگاه داده شده با گزینه های پیش فرض راه اندازی می کند. بیشتر... | |
(instancetype) | - initWithDevice:traits:sessionID:sessionOptions: |
یک شی جلسه جدید را برای دستگاه داده شده راه اندازی می کند. بیشتر... | |
( GCKRequest *) | - setDeviceVolume: |
میزان صدای دستگاه را تنظیم می کند. بیشتر... | |
( GCKRequest *) | - setDeviceMuted: |
وضعیت بی صدا دستگاه را تنظیم می کند. بیشتر... | |
(void) | - start |
جلسه را شروع می کند. بیشتر... | |
(void) | - endWithAction: |
جلسه را با عمل مشخص شده به پایان می رساند. بیشتر... | |
(void) | - notifyDidStartWithSessionID: |
توسط زیر کلاس ها فراخوانی می شود تا به فریم ورک اطلاع دهد که جلسه شروع شده است. بیشتر... | |
(void) | - notifyDidFailToStartWithError: |
توسط زیر کلاسها فراخوانی میشود تا به چارچوب اطلاع دهد که جلسه شروع نشده است. بیشتر... | |
(void) | - notifyDidEndWithError:willTryToResume: |
توسط زیر کلاس ها فراخوانی می شود تا به فریم ورک اطلاع دهد که جلسه به پایان رسیده است. بیشتر... | |
(void) | - notifyDidReceiveDeviceVolume:muted: |
توسط کلاسهای فرعی فراخوانی میشود تا به فریمورک اطلاع دهد که حجم دستگاه بهروز شده و وضعیت بیصدا از دستگاه دریافت شده است. بیشتر... | |
(void) | - notifyDidReceiveDeviceStatus: |
توسط زیر کلاسها فراخوانی میشود تا به چارچوب اطلاع دهد که وضعیت بهروزرسانی شده از دستگاه دریافت شده است. بیشتر... | |
(void) | - notifyDidSuspendWithReason: |
منسوخ شده، استفاده نکنید - به عنوان بدون عملیات پیاده سازی شده است. بیشتر... | |
(void) | - notifyDidResume |
منسوخ شده، استفاده نکنید - به عنوان بدون عملیات پیاده سازی شده است. بیشتر... | |
خلاصه اموال | |
GCKActiveInputStatus | activeInputStatus |
وضعیت فعلی «ورودی فعال» دستگاه. بیشتر... | |
GCKStandbyStatus | standbyStatus |
وضعیت فعلی "آماده به کار" دستگاه. بیشتر... | |
GCKApplicationMetadata * | applicationMetadata |
ابرداده برای برنامه گیرنده که در حال حاضر روی دستگاه گیرنده اجرا می شود، در صورت وجود؛ در غیر این صورت nil . بیشتر... | |
GCKDevice * | device |
دستگاهی که این جلسه با آن مرتبط است. بیشتر... | |
NSString * | sessionID |
شناسه جلسه فعلی، در صورت وجود. بیشتر... | |
GCKSessionOptions * | sessionOptions |
گزینه های جلسه، در صورت وجود. بیشتر... | |
GCKConnectionState | connectionState |
وضعیت اتصال جلسه فعلی. بیشتر... | |
BOOL | suspended |
پرچمی که نشان می دهد آیا جلسه در حال حاضر به حالت تعلیق درآمده است یا خیر. بیشتر... | |
NSString * | deviceStatusText |
متن وضعیت فعلی دستگاه. بیشتر... | |
GCKSessionTraits * | traits |
ویژگی های جلسه بیشتر... | |
float | currentDeviceVolume |
حجم فعلی دستگاه، در محدوده [0.0، 1.0]. بیشتر... | |
BOOL | currentDeviceMuted |
وضعیت قطعی دستگاه فعلی. بیشتر... | |
GCKRemoteMediaClient * | remoteMediaClient |
شی GCKRemoteMediaClient که می تواند برای کنترل پخش رسانه در این جلسه استفاده شود. بیشتر... | |
GCKMediaMetadata * | mediaMetadata |
فراداده رسانه فعلی، در صورت وجود. بیشتر... | |
جزئیات روش
- (instancetype) initWithDevice: | ( GCKDevice *) | device | |
sessionID: | (nullable NSString *) | sessionID | |
sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
castOptions: | ( GCKCastOptions *) | castOptions | |
یک جلسه Cast جدید با گزینههای Cast میسازد.
- Parameters
-
device The receiver device. sessionID The session ID, if resuming; otherwise nil
.sessionOptions The session options, if any; otherwise nil
.castOptions The Cast options.
- از آنجا که
- 4.0
- (BOOL) addChannel: | ( GCKCastChannel *) | channel |
یک کانال با جلسه ثبت می کند.
اگر جلسه متصل باشد و برنامه گیرنده از فضای نام کانال پشتیبانی کند، کانال به طور خودکار متصل می شود. اگر جلسه وصل نباشد، کانال تا شروع جلسه در حالت قطع می ماند.
- Parameters
-
channel The channel to register.
- برمی گرداند
-
YES
اگر کانال با موفقیت ثبت شد خیر، در غیر این صورتNO
.
- (BOOL) removeChannel: | ( GCKCastChannel *) | channel |
کانالی که قبلا ثبت نام کرده اید را از جلسه حذف می کند.
- Parameters
-
channel The channel to unregister.
- برمی گرداند
-
YES
اگر کانال با موفقیت لغو شد،NO
در غیر این صورت.
- (void) addDeviceStatusListener: | (id< GCKCastDeviceStatusListener >) | listener |
یک GCKCastDeviceStatusListener را به لیست شنوندگان این شی اضافه می کند.
شنونده اضافه شده ضعیف نگه داشته می شود و برای جلوگیری از انتقال غیرمنتظره باید حفظ شود.
- Parameters
-
listener The listener to add.
- (void) removeDeviceStatusListener: | (id< GCKCastDeviceStatusListener >) | listener |
یک GCKCastDeviceStatusListener را از لیست شنوندگان این شی حذف می کند.
- Parameters
-
listener The listener to remove.
- ( GCKRequest *) setDeviceVolume: | (float) | volume | |
forMultizoneDevice: | ( GCKMultizoneDevice *) | device | |
میزان صدای هر دستگاه را در یک گروه چند منطقه ای تنظیم می کند.
این یک عملیات ناهمزمان است.
- Parameters
-
volume The new volume, in the range [0.0, 1.0]. device The multizone device.
- برمی گرداند
- یک شیء GCKRequest برای ردیابی درخواست.
- ( GCKRequest *) setDeviceMuted: | (BOOL) | muted | |
forMultizoneDevice: | ( GCKMultizoneDevice *) | device | |
حالت بیصدا دستگاه را در یک گروه چند منطقهای تنظیم میکند.
این یک عملیات ناهمزمان است.
- Parameters
-
muted The new muted state. device The multizone device.
- برمی گرداند
- یک شیء GCKRequest برای ردیابی درخواست.
- ( GCKRequest *) requestMultizoneStatus |
درخواست وضعیت چند منطقه ای از یک گروه چند منطقه ای.
این یک عملیات ناهمزمان است. هنگامی که وضعیت چند منطقه ای دریافت می شود، روش نمایندگی castSession:didReceiveMultizoneStatus: (GCKCastDeviceStatusListener-p) پیام داده می شود.
- برمی گرداند
- یک شیء GCKRequest برای ردیابی درخواست.
- (instancetype) initWithDevice: | ( GCKDevice *) | device | |
traits: | (nullable GCKSessionTraits *) | traits | |
sessionID: | (nullable NSString *) | sessionID | |
یک شی جلسه جدید را برای دستگاه داده شده با گزینه های پیش فرض راه اندازی می کند.
- Parameters
-
device The device. traits The session traits. sessionID The session ID of an existing session, if this object will be used to resume a session; otherwise nil
if it will be used to start a new session.
- (instancetype) initWithDevice: | ( GCKDevice *) | device | |
traits: | (nullable GCKSessionTraits *) | traits | |
sessionID: | (nullable NSString *) | sessionID | |
sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
یک شی جلسه جدید را برای دستگاه داده شده راه اندازی می کند.
- Parameters
-
device The device. traits The session traits. sessionID The session ID of an existing session, if this object will be used to resume a session; otherwise nil
if it will be used to start a new session.sessionOptions The session options, if any; otherwise nil
.
- از آنجا که
- 4.0
- ( GCKRequest *) setDeviceVolume: | (float) | volume |
میزان صدای دستگاه را تنظیم می کند.
این یک عملیات ناهمزمان است. اجرای پیشفرض یک No-op است که با یک خطای GCKErrorCodeUnsupportedFeature، درخواست را با شکست مواجه میکند.
- Parameters
-
volume The new volume.
- برمی گرداند
- یک شی GCKRequest برای ردیابی درخواست.
- از آنجا که
- 3.4; در نسخه های فریمورک قبلی، این روش
void
برگرداند.
- ( GCKRequest *) setDeviceMuted: | (BOOL) | muted |
وضعیت بی صدا دستگاه را تنظیم می کند.
این یک عملیات ناهمزمان است. اجرای پیشفرض یک No-op است که با یک خطای GCKErrorCodeUnsupportedFeature، درخواست را با شکست مواجه میکند.
- Parameters
-
muted The new mute state.
- برمی گرداند
- یک شی GCKRequest برای ردیابی درخواست.
- از آنجا که
- 3.4; در نسخه های فریمورک قبلی، این روش
void
برگرداند.
- (void) start |
جلسه را شروع می کند.
این یک عملیات ناهمزمان است. باید توسط زیر کلاس ها لغو شود.
ارائه شده توسط دسته GCKSession(Protected) .
- (void) endWithAction: | ( GCKSessionEndAction ) | action |
جلسه را با عمل مشخص شده به پایان می رساند.
این یک عملیات ناهمزمان است. باید توسط زیر کلاس ها لغو شود.
- Parameters
-
action The action to take when ending the session; see GCKSessionEndAction for more details.
ارائه شده توسط دسته GCKSession(Protected) .
- (void) notifyDidStartWithSessionID: | (NSString *) | sessionID |
توسط زیر کلاس ها فراخوانی می شود تا به فریم ورک اطلاع دهد که جلسه شروع شده است.
- Parameters
-
sessionID The session's unique ID.
ارائه شده توسط دسته GCKSession(Protected) .
- (void) notifyDidFailToStartWithError: | ( GCKError *) | error |
توسط زیر کلاسها فراخوانی میشود تا به چارچوب اطلاع دهد که جلسه شروع نشده است.
- Parameters
-
error The error that occurred.
ارائه شده توسط دسته GCKSession(Protected) .
- (void) notifyDidEndWithError: | (nullable NSError *) | error | |
willTryToResume: | (BOOL) | willTryToResume | |
توسط زیر کلاس ها فراخوانی می شود تا به فریم ورک اطلاع دهد که جلسه به پایان رسیده است.
- Parameters
-
error The error that caused the session to end, if any. Should be nil
if the session was ended intentionally.willTryToResume Whether the session will try to resume itself automatically.
ارائه شده توسط دسته GCKSession(Protected) .
- (void) notifyDidReceiveDeviceVolume: | (float) | volume | |
muted: | (BOOL) | muted | |
توسط کلاسهای فرعی فراخوانی میشود تا به فریمورک اطلاع دهد که حجم دستگاه بهروز شده و وضعیت بیصدا از دستگاه دریافت شده است.
- Parameters
-
volume The device's current volume. Must be in the range [0, 1.0]; muted The device's current mute state.
ارائه شده توسط دسته GCKSession(Protected) .
- (void) notifyDidReceiveDeviceStatus: | (nullable NSString *) | statusText |
توسط زیر کلاسها فراخوانی میشود تا به چارچوب اطلاع دهد که وضعیت بهروزرسانی شده از دستگاه دریافت شده است.
- Parameters
-
statusText The new status.
ارائه شده توسط دسته GCKSession(Protected) .
- (void) notifyDidSuspendWithReason: | ( GCKConnectionSuspendReason ) | reason |
منسوخ شده، استفاده نکنید - به عنوان بدون عملیات پیاده سازی شده است.
- Deprecated:
- زنگ نزن.
ارائه شده توسط دسته GCKSession(Protected) .
- (void) notifyDidResume |
منسوخ شده، استفاده نکنید - به عنوان بدون عملیات پیاده سازی شده است.
- Deprecated:
- زنگ نزن.
ارائه شده توسط دسته GCKSession(Protected) .
جزئیات ملک
|
read nonatomic assign |
وضعیت فعلی «ورودی فعال» دستگاه.
|
read nonatomic assign |
وضعیت فعلی "آماده به کار" دستگاه.
|
read nonatomic copy |
ابرداده برای برنامه گیرنده که در حال حاضر روی دستگاه گیرنده اجرا می شود، در صورت وجود؛ در غیر این صورت nil
.
|
read nonatomic strong inherited |
دستگاهی که این جلسه با آن مرتبط است.
|
read nonatomic copy inherited |
شناسه جلسه فعلی، در صورت وجود.
|
read nonatomic strong inherited |
گزینه های جلسه، در صورت وجود.
- از آنجا که
- 4.0
|
read nonatomic assign inherited |
وضعیت اتصال جلسه فعلی.
|
read nonatomic assign inherited |
پرچمی که نشان می دهد آیا جلسه در حال حاضر به حالت تعلیق درآمده است یا خیر.
- Deprecated:
- GCKSession دیگر از حالت تعلیق پشتیبانی نمیکند. در صورت نیاز، این قابلیت را به یک زیر کلاس منتقل کنید.
|
read nonatomic copy inherited |
متن وضعیت فعلی دستگاه.
|
read nonatomic copy inherited |
ویژگی های جلسه
|
read nonatomic assign inherited |
حجم فعلی دستگاه، در محدوده [0.0، 1.0].
|
read nonatomic assign inherited |
وضعیت قطعی دستگاه فعلی.
|
read nonatomic strong inherited |
شی GCKRemoteMediaClient که می تواند برای کنترل پخش رسانه در این جلسه استفاده شود.
قبل از شروع جلسه nil
است، یا اگر جلسه از GCKRemoteMediaClient API پشتیبانی نمی کند. کلاسهای فرعی که یک رابط GCKRemoteMediaClient ارائه میکنند باید روش گیرنده را لغو کنند.
|
read nonatomic strong inherited |
فراداده رسانه فعلی، در صورت وجود.
اگر جلسه از فضای نام رسانه پشتیبانی نکند یا در حال حاضر هیچ رسانه ای روی گیرنده بارگذاری نشده باشد، nil
خواهد بود.