بررسی اجمالی

کنترل‌کننده‌ای برای دستگاه‌های Cast.

این کلاس می‌تواند برنامه‌هایی را که روی دستگاه Cast اجرا می‌شوند، ارسال کند، پیام‌ها را دریافت کند، راه‌اندازی کند و ببندد.

نمونه GCKDeviceManager باید تا زمانی که اتصال به دستگاه Cast برقرار است یا در حال ایجاد یا از بین رفتن است، در محدوده باقی بماند. آزاد کردن شیء قبل از شروع اتصال با connect (GCKDeviceManager) یا بعد از deviceManager:didDisconnectWithError: (GCKDeviceManagerDelegate-p) , deviceManager:didSuspendConnectionWithReason: (GCKDeviceManagerDelegate-p) deviceManager:didFailToConnectWithError: (GCKDeviceManagerDelegate-p) نمایندگی فراخوانی شده است.

Deprecated:: از GCKSessionManager و GCKCastSession برای تعامل با گیرنده های Cast استفاده کنید.

NSObject را به ارث می برد.

خلاصه روش نمونه
(instancetype)	- initWithDevice:clientPackageName:
	یک GCKDeviceManager جدید با دستگاه داده شده می سازد. بیشتر...

(instancetype)	- initWithDevice:clientPackageName:ignoreAppStateNotifications:
	مقداردهی اولیه تعیین شده بیشتر...

(void)	- connect
	به دستگاه متصل می شود. بیشتر...

(void)	- disconnect
	از دستگاه قطع می شود. بیشتر...

(void)	- disconnectWithLeave:
	از دستگاه قطع می شود. بیشتر...

(BOOL)	- addChannel:
	کانالی را اضافه می کند که می تواند پیام های این دستگاه را در یک فضای نام خاص ارسال و دریافت کند. بیشتر...

(BOOL)	- removeChannel:
	یک کانال اضافه شده قبلی را حذف می کند. بیشتر...

(NSInteger)	- launchApplication:
	برنامه ای را راه اندازی می کند. بیشتر...

(NSInteger)	- launchApplication:withLaunchOptions:
	یک برنامه را با استفاده از گزینه های راه اندازی داده شده راه اندازی می کند. بیشتر...

(NSInteger)	- launchApplication:relaunchIfRunning:
	یک برنامه را راه اندازی می کند و اگر قبلاً در حال اجرا است، به صورت اختیاری آن را دوباره راه اندازی می کند. بیشتر...

(NSInteger)	- joinApplication:
	به یک برنامه می پیوندد. بیشتر...

(NSInteger)	- joinApplication:sessionID:
	به یک برنامه با شناسه جلسه برنامه خاص می پیوندد. بیشتر...

(BOOL)	- leaveApplication
	برنامه فعلی را ترک می کند. بیشتر...

(NSInteger)	- stopApplication
	هر برنامه (های) در حال اجرا را متوقف می کند. بیشتر...

(NSInteger)	- stopApplicationWithSessionID:
	برنامه را با شناسه جلسه برنامه داده شده متوقف می کند. بیشتر...

(NSInteger)	- setVolume:
	حجم سیستم را تنظیم می کند. بیشتر...

(NSInteger)	- setMuted:
	نادیده گرفتن را روشن یا خاموش می کند. بیشتر...

(NSInteger)	- requestDeviceStatus
	وضعیت فعلی دستگاه را درخواست می کند. بیشتر...

خلاصه اموال
BOOL	ignoreAppStateNotifications
	آیا این شی به اعلان‌های وضعیت برنامه گوش می‌دهد یا خیر. بیشتر...

GCKConnectionState	connectionState
	وضعیت اتصال فعلی مدیر دستگاه. بیشتر...

GCKConnectionState	applicationConnectionState
	وضعیت اتصال برنامه فعلی مدیر دستگاه. بیشتر...

BOOL	isConnected
	درست است اگر مدیر دستگاه با دستگاه ارتباط برقرار کرده باشد. بیشتر...

BOOL	isConnectedToApp
	درست است اگر مدیر دستگاه با یک برنامه در دستگاه ارتباط برقرار کرده باشد. بیشتر...

BOOL	isReconnecting
	درست است اگر مدیر دستگاه به دلیل یک رویداد بالقوه گذرا قطع شده باشد (به عنوان مثال، برنامه در پس‌زمینه است یا یک خطای شبکه وجود دارد که ممکن است با اتصال مجدد برطرف شود). بیشتر...

NSTimeInterval	reconnectTimeout
	در صورتی که سوکت با یک خطای بالقوه گذرا قطع شود، برای این مدت تلاش مجدد انجام می شود. بیشتر...

GCKDevice *	device
	دستگاهی که توسط این GCKDeviceManager کنترل می شود. بیشتر...

id< GCKDeviceManagerDelegate >	delegate
	نماینده دریافت اعلان‌ها از GCKDeviceManager . بیشتر...

float	deviceVolume
	حجم فعلی دستگاه در محدوده [0.0، 1.0]، اگر مشخص باشد. در غیر این صورت 0. بیشتر...

BOOL	deviceMuted
	وضعیت قطعی فعلی دستگاه، اگر مشخص باشد؛ در غیر این صورت `NO` بیشتر...

GCKActiveInputStatus	activeInputStatus
	وضعیت فعلی «ورودی فعال» دستگاه. بیشتر...

GCKStandbyStatus	standbyStatus
	وضعیت فعلی «آماده به کار» دستگاه. بیشتر...

NSString *	applicationSessionID
	شناسه جلسه برنامه برای برنامه گیرنده فعلی متصل شده، در صورت وجود؛ در غیر این صورت `nil` . بیشتر...

GCKApplicationMetadata *	applicationMetadata
	ابرداده برای برنامه گیرنده که در حال حاضر روی گیرنده اجرا می شود، در صورت وجود؛ در غیر این صورت `nil` . بیشتر...

NSString *	applicationStatusText
	آخرین متن وضعیت گزارش شده از برنامه گیرنده در حال اجرا، در صورت وجود؛ در غیر این صورت `nil` . بیشتر...

جزئیات روش

- (instancetype) initWithDevice:	( GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName

یک GCKDeviceManager جدید با دستگاه داده شده می سازد.

شی به اعلان‌های وضعیت برنامه گوش می‌دهد و وقتی برنامه به پس‌زمینه می‌رود، به‌طور خودکار از دستگاه جدا می‌شود و وقتی برنامه به پیش‌زمینه برمی‌گردد، تلاش می‌کند دوباره به دستگاه متصل شود.

Parameters

device	The device to control.
clientPackageName	The client package name.

- (instancetype) initWithDevice:	( GCKDevice *)	device
clientPackageName:	(NSString *)	clientPackageName
ignoreAppStateNotifications:	(BOOL)	ignoreAppStateNotifications

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

یک GCKDeviceManager جدید برای کنترل دستگاه داده شده می سازد.

اگر ignoreAppStateNotifications NO باشد، شی به تغییرات در وضعیت برنامه گوش می دهد و هنگامی که برنامه به پس زمینه می رود، به طور خودکار از دستگاه جدا می شود و زمانی که برنامه به پیش زمینه برمی گردد، سعی می کند دوباره به دستگاه متصل شود.

اگر ignoreAppStateNotifications YES باشد، شیء به این اعلان‌ها گوش نمی‌دهد و مسئولیت مدیریت چرخه عمر اتصال به عهده برنامه خواهد بود. توجه داشته باشید که به طور کلی، یک برنامه iOS پس‌زمینه نمی‌تواند به‌طور نامحدود به اجرا ادامه دهد و اتصالات شبکه فعال آن در نهایت توسط سیستم عامل بسته می‌شود.

Parameters

device	The device to control.
clientPackageName	The client package name.
ignoreAppStateNotifications	Whether this object will ignore app state notifications.

- (void) connect

به دستگاه متصل می شود.

- (void) disconnect

از دستگاه قطع می شود.

این قطع ارتباط صریح است.

یکی از روش های قطع باید در نقطه ای پس از فراخوانی connect و قبل از اینکه این شی توسط صاحبش آزاد شود فراخوانی شود.

- (void) disconnectWithLeave: (BOOL) leaveApplication

از دستگاه قطع می شود.

یکی از روش های قطع باید در نقطه ای پس از فراخوانی connect و قبل از اینکه این شی توسط صاحبش آزاد شود فراخوانی شود.

Parameters

leaveApplication YES if this is an explicit disconnect that should disconnect from ("leave") the receiver application before closing the connection; NO if this is an implicit disconnect that should just close the connection.

- (BOOL) addChannel: ( GCKCastChannel *) channel

کانالی را اضافه می کند که می تواند پیام های این دستگاه را در یک فضای نام خاص ارسال و دریافت کند.

Parameters

channel The channel.

برمی گرداند: اگر کانال اضافه شده باشد YES ، اگر اضافه نشده باشد NO ، زیرا قبلاً کانالی برای آن فضای نام ضمیمه شده است.

- (BOOL) removeChannel: ( GCKCastChannel *) channel

یک کانال اضافه شده قبلی را حذف می کند.

Parameters

channel The channel.

برمی گرداند: اگر کانال حذف شده باشد YES ، اگر کانال حذف نشده باشد NO ، زیرا کانال داده شده قبلاً ضمیمه نشده است.

- (NSInteger) launchApplication: (NSString *) applicationID

برنامه ای را راه اندازی می کند.

Parameters

applicationID The application ID.

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (NSInteger) launchApplication:	(NSString *)	applicationID
withLaunchOptions:	( GCKLaunchOptions *__nullable)	launchOptions

یک برنامه را با استفاده از گزینه های راه اندازی داده شده راه اندازی می کند.

Parameters

applicationID	The application ID.
launchOptions	The launch options for this request. If `nil` , defaults will be used.

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (NSInteger) launchApplication:	(NSString *)	applicationID
relaunchIfRunning:	(BOOL)	relaunchIfRunning

یک برنامه را راه اندازی می کند و اگر قبلاً در حال اجرا است، به صورت اختیاری آن را دوباره راه اندازی می کند.

Deprecated:: به جای آن از launchApplication:withLaunchOptions: استفاده کنید.

Parameters

applicationID	The application ID.
relaunchIfRunning	If `YES` , relaunches the application if it is already running instead of joining the running application.

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (NSInteger) joinApplication: (NSString *__nullable) applicationID

به یک برنامه می پیوندد.

Parameters

applicationID The application ID. If nil , attempts to join whichever application is currently running; otherwise, attempts to join the specified application.

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (NSInteger) joinApplication:	(NSString *)	applicationID
sessionID:	(NSString *)	sessionID

به یک برنامه با شناسه جلسه برنامه خاص می پیوندد.

اگر شناسه جلسه داده شده دیگر روی گیرنده فعال نباشد، درخواست ناموفق خواهد بود.

Parameters

applicationID	The application ID.
sessionID	The application session ID.

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (BOOL) leaveApplication

برنامه فعلی را ترک می کند.

برمی گرداند: اگر پیام ارسال نشد NO .

- (NSInteger) stopApplication

هر برنامه (های) در حال اجرا را متوقف می کند.

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (NSInteger) stopApplicationWithSessionID: (NSString *__nullable) sessionID

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

اگر شناسه جلسه داده شده دیگر روی گیرنده فعال نباشد، درخواست ناموفق خواهد بود.

Parameters

sessionID The application session ID, which may not be nil .

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (NSInteger) setVolume: (float) volume

حجم سیستم را تنظیم می کند.

Parameters

volume The new volume, in the range [0.0, 1.0]. Out of range values will be silently clipped.

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (NSInteger) setMuted: (BOOL) muted

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

Parameters

muted Whether audio should be muted or unmuted.

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

- (NSInteger) requestDeviceStatus

وضعیت فعلی دستگاه را درخواست می کند.

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

برمی گرداند: شناسه درخواست یا kGCKInvalidRequestID اگر درخواست ارسال نشد.

جزئیات ملک

- (BOOL) ignoreAppStateNotifications

read nonatomic assign

آیا این شی به اعلان‌های وضعیت برنامه گوش می‌دهد یا خیر.

این پرچم ممکن است در مقداردهی اولیه مشخص شود. مقدار پیش فرض NO است.

- ( GCKConnectionState ) connectionState

read nonatomic assign

وضعیت اتصال فعلی مدیر دستگاه.

- ( GCKConnectionState ) applicationConnectionState

read nonatomic assign

وضعیت اتصال برنامه فعلی مدیر دستگاه.

- (BOOL) isConnected

read nonatomic assign

درست است اگر مدیر دستگاه با دستگاه ارتباط برقرار کرده باشد.

Deprecated:: از connectionState استفاده کنید.

- (BOOL) isConnectedToApp

read nonatomic assign

درست است اگر مدیر دستگاه با یک برنامه در دستگاه ارتباط برقرار کرده باشد.

Deprecated:: از applicationConnectionState استفاده کنید.

- (BOOL) isReconnecting

read nonatomic assign

درست است اگر مدیر دستگاه به دلیل یک رویداد بالقوه گذرا قطع شده باشد (به عنوان مثال، برنامه در پس‌زمینه است یا یک خطای شبکه وجود دارد که ممکن است با اتصال مجدد برطرف شود).

توجه داشته باشید که وقتی مدیر دستگاه تلاش می‌کند پس از یک رویداد بالقوه گذرا دوباره وصل شود، تماس‌های قطع/اتصال فراخوانی نمی‌شوند، اما ویژگی‌ها همیشه وضعیت فعلی واقعی را منعکس می‌کنند و قابل مشاهده هستند.

- (NSTimeInterval) reconnectTimeout

read write nonatomic assign

در صورتی که سوکت با یک خطای بالقوه گذرا قطع شود، برای این مدت تلاش مجدد انجام می شود.

مدت زمان پیش فرض 15 ثانیه است.

- ( GCKDevice *) device

read nonatomic assign

دستگاهی که توسط این GCKDeviceManager کنترل می شود.

- (id< GCKDeviceManagerDelegate >) delegate

read write nonatomic weak

نماینده دریافت اعلان‌ها از GCKDeviceManager .

- (float) deviceVolume

read nonatomic assign

حجم فعلی دستگاه در محدوده [0.0، 1.0]، اگر مشخص باشد. در غیر این صورت 0.

- (BOOL) deviceMuted

read nonatomic assign

وضعیت قطعی فعلی دستگاه، اگر مشخص باشد؛ در غیر این صورت NO

- ( GCKActiveInputStatus ) activeInputStatus

read nonatomic assign

وضعیت فعلی «ورودی فعال» دستگاه.

- ( GCKStandbyStatus ) standbyStatus

read nonatomic assign

وضعیت فعلی "آماده به کار" دستگاه.

- (NSString*) applicationSessionID

read nonatomic copy

شناسه جلسه برنامه برای برنامه گیرنده فعلی متصل شده، در صورت وجود؛ در غیر این صورت nil .

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

- ( GCKApplicationMetadata *) applicationMetadata

read nonatomic copy

ابرداده برای برنامه گیرنده که در حال حاضر روی گیرنده اجرا می شود، در صورت وجود؛ در غیر این صورت nil .

- (NSString*) applicationStatusText

read nonatomic copy

آخرین متن وضعیت گزارش شده از برنامه گیرنده در حال اجرا، در صورت وجود؛ در غیر این صورت nil .

کلاس GCKDeviceManager

بررسی اجمالی

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

خلاصه اموال

جزئیات روش

جزئیات ملک