סקירה כללית

כיתת משנה GCKCastChannel עבור פעולות של בקרת מדיה.

כל פעולה שחלה על שידור חי פעיל (הפעלה, השהיה, חיפוש, עצירה וכו') מחייבת סטטוס מדיה תקין (כלומר, nil). אחרת, היא תחזיר את הערך kGCKInvalidRequestID ולא תשלח את הבקשה. בקשת מדיה נשלחת באופן אוטומטי כשהערוץ מתחבר, והסטטוס שלו כולל מנוחה של טעינה הושלמה. אפשר גם לעדכן אותה בכל שלב. בנוסף, יכול להיות שסטטוס המדיה ישתנה לאפס בכל שלב. המצב הזה יקרה אם הערוץ מנותק זמנית, לדוגמה. כשמשתמשים בערוץ הזה, צריך לעקוב אחר שינויים בסטטוס המדיה באמצעות הקריאה החוזרת (mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p)) של שיטות התקשרות. יש להפעיל שיטות שפועלות בשידורים רק אם סטטוס המדיה הוא אפס.

אם בקשה מסוימת נשלחה בהצלחה, השיטה המתאימה מחזירה את מזהה הבקשה שהוקצה לבקשה. אם הבקשה נכשלה, השיטה מחזירה את הפרמטר kGCKInvalidRequestID ומגדירה את המאפיין lastError כדי לציין את הסיבה לכישלון. אם הבקשה התחילה בהצלחה אבל בסופו של דבר היא תיכשל, ה-callback של mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p) יופעל כדי לציין שהכשל.

אפשר למצוא מידע נוסף על הפרוטוקול להאצלה ב-GCKMediaControlChannelDelegate.

Deprecated:: שימוש בנכס GCKRemoteMediaClient של GCKCastSession לשליטה בהפעלת מדיה.

עוברת בירושה את GCKCastChannel.

סיכום של שיטת המכונה
(instancetype)	- init
	מאתחל ייעודי. עוד...

(NSInteger)	- loadMedia:
	מתבצעת טעינה והתחלת הפעלה של פריט מדיה חדש. עוד...

(NSInteger)	- loadMedia:autoplay:
	טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש. עוד...

(NSInteger)	- loadMedia:autoplay:playPosition:
	טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש. עוד...

(NSInteger)	- loadMedia:autoplay:playPosition:customData:
	טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש. עוד...

(NSInteger)	- loadMedia:autoplay:playPosition:activeTrackIDs:
	טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש. עוד...

(NSInteger)	- loadMedia:autoplay:playPosition:activeTrackIDs:customData:
	טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש. עוד...

(NSInteger)	- setActiveTrackIDs:
	מגדירה את המסלולים הפעילים. עוד...

(NSInteger)	- setTextTrackStyle:
	מגדיר את סגנון רצועת הטקסט. עוד...

(NSInteger)	- pause
	השהיית ההפעלה של פריט המדיה הנוכחי. עוד...

(NSInteger)	- pauseWithCustomData:
	השהיית ההפעלה של פריט המדיה הנוכחי. עוד...

(NSInteger)	- stop
	מפסיק את ההפעלה של פריט המדיה הנוכחי. עוד...

(NSInteger)	- stopWithCustomData:
	מפסיק את ההפעלה של פריט המדיה הנוכחי. עוד...

(NSInteger)	- play
	מתחיל (או חוזר) הפעלה של פריט המדיה הנוכחי. עוד...

(NSInteger)	- playWithCustomData:
	מתחיל (או חוזר) הפעלה של פריט המדיה הנוכחי. עוד...

(NSInteger)	- seekToTimeInterval:
	חיפוש במיקום חדש בתוך פריט המדיה הנוכחי. עוד...

(NSInteger)	- seekToTimeInterval:resumeState:
	חיפוש במיקום חדש בתוך פריט המדיה הנוכחי. עוד...

(NSInteger)	- seekToTimeInterval:resumeState:customData:
	חיפוש במיקום חדש בתוך פריט המדיה הנוכחי. עוד...

(NSInteger)	- queueLoadItems:startIndex:repeatMode:
	טוענת, ובאופן אופציונלי מתחילה הפעלה של תור חדש של פריטי מדיה. עוד...

(NSInteger)	- queueLoadItems:startIndex:repeatMode:customData:
	טוענת, ובאופן אופציונלי מתחילה הפעלה של תור חדש של פריטי מדיה. עוד...

(NSInteger)	- queueLoadItems:startIndex:playPosition:repeatMode:customData:
	טוענת, ובאופן אופציונלי מתחילה הפעלה של תור חדש של פריטי מדיה. עוד...

(NSInteger)	- queueInsertItems:beforeItemWithID:
	הוספת רשימה של פריטי מדיה חדשים ל'הבאים בתור'. עוד...

(NSInteger)	- queueInsertItems:beforeItemWithID:customData:
	הוספת רשימה של פריטי מדיה חדשים ל'הבאים בתור'. עוד...

(NSInteger)	- queueInsertItem:beforeItemWithID:
	שיטת נוחות שמכניסה פריט יחיד ל'הבאים בתור'. עוד...

(NSInteger)	- queueInsertAndPlayItem:beforeItemWithID:
	שיטת נוחות שמכניסה פריט יחיד ל'הבאים בתור' והופכת אותו לפריט הנוכחי. עוד...

(NSInteger)	- queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
	שיטת נוחות שמכניסה פריט יחיד ל'הבאים בתור' והופכת אותו לפריט הנוכחי. עוד...

(NSInteger)	- queueUpdateItems:
	התור מתעדכן. עוד...

(NSInteger)	- queueUpdateItems:customData:
	התור מתעדכן. עוד...

(NSInteger)	- queueRemoveItemsWithIDs:
	הסרת רשימה של פריטי מדיה מהתור. עוד...

(NSInteger)	- queueRemoveItemsWithIDs:customData:
	הסרת רשימה של פריטי מדיה מהתור. עוד...

(NSInteger)	- queueRemoveItemWithID:
	שיטת נוחות שמסירה פריט יחיד מ'הבאים בתור'. עוד...

(NSInteger)	- queueReorderItemsWithIDs:insertBeforeItemWithID:
	שינוי הסדר של פריטי מדיה בתור. עוד...

(NSInteger)	- queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
	אפשר לשנות את הסדר של רשימת פריטי מדיה שנמצאים בתור. עוד...

(NSInteger)	- queueMoveItemWithID:beforeItemWithID:
	שיטת נוחות שמזיזה פריט יחיד בתור. עוד...

(NSInteger)	- queueJumpToItemWithID:
	קופץ לפריט עם המזהה שצוין בתור. עוד...

(NSInteger)	- queueJumpToItemWithID:customData:
	קופץ לפריט עם המזהה שצוין בתור. עוד...

(NSInteger)	- queueJumpToItemWithID:playPosition:customData:
	קופץ לפריט עם המזהה שצוין בתור. עוד...

(NSInteger)	- queueNextItem
	מעבר לפריט הבא בתור. עוד...

(NSInteger)	- queuePreviousItem
	מעבר לפריט הקודם בתור. עוד...

(NSInteger)	- queueSetRepeatMode:
	מגדיר את מצב החזרה של התור. עוד...

(NSInteger)	- setStreamVolume:
	מגדיר את עוצמת הקול של הסטרימינג. עוד...

(NSInteger)	- setStreamVolume:customData:
	מגדיר את עוצמת הקול של הסטרימינג. עוד...

(NSInteger)	- setStreamMuted:
	הגדרה זו קובעת אם הסטרימינג יושתק. עוד...

(NSInteger)	- setStreamMuted:customData:
	הגדרה זו קובעת אם הסטרימינג יושתק. עוד...

(NSInteger)	- requestStatus
	מבקש מהצד המקבל מידע עדכני על סטטוס המדיה. עוד...

(NSTimeInterval)	- approximateStreamPosition
	מחזירה את המיקום המשוער של השידור כפי שמחושב מנתוני הסטרימינג האחרונים שהתקבלו, ואת זמן המעבר שחלף מאז העדכון הזה. עוד...

(BOOL)	- cancelRequestWithID:
	ביטול בקשה בתהליך. עוד...

(instancetype)	- initWithNamespace:
	מאתחל ייעודי. עוד...

(void)	- didReceiveTextMessage:
	מתקשרים כאשר מתקבלת הודעת טקסט בערוץ הזה. עוד...

(BOOL)	- sendTextMessage:
	תישלח הודעת טקסט בערוץ. עוד...

(BOOL)	- sendTextMessage:error:
	תישלח הודעת טקסט בערוץ. עוד...

(NSInteger)	- generateRequestID
	יוצר מזהה בקשה להודעה חדשה. עוד...

(NSNumber *__nullable)	- generateRequestNumber
	שיטת נוחות שמעטפת את התוצאה של generateRequestID ב-NSNumber. עוד...

(void)	- didConnect
	התקשרות כשהערוץ מחובר. המשמעות היא שניתן להחליף עכשיו הודעות עם מכשיר CAST בערוץ הזה. עוד...

(void)	- didDisconnect
	בוצעה שיחה כאשר הערוץ הזה נותק. פירוש הדבר הוא שלא ניתן יותר להחליף הודעות עם מכשיר ה-CAST דרך הערוץ הזה. עוד...

סיכום הנכס
GCKMediaStatus *	mediaStatus
	סטטוס המדיה של המדיה שנטענת כרגע, אם יש כזו. אחרת, `nil`. עוד...

NSTimeInterval	timeSinceLastMediaStatusUpdate
	משך הזמן שעבר מאז התקבל העדכון האחרון של סטטוס המדיה. עוד...

GCKError *	lastError
	פרטי השגיאה מהבקשה האחרונה, אם הייתה כזו, או `nil` אם הבקשה האחרונה הושלמה בהצלחה. עוד...

id< GCKMediaControlChannelDelegate >	delegate
	בעל הגישה מקבל התראות על שינויים במצב הערוץ. עוד...

NSString *	protocolNamespace
	מרחב השמות של הערוץ. עוד...

BOOL	isConnected
	סימון שמציין אם הערוץ מחובר כרגע. עוד...

GCKDeviceManager *	deviceManager
	מנהל המכשיר שבאמצעותו רשום הערוץ הזה, אם יש כזה. עוד...

פרטי השיטה

- (instancetype) init

מאתחל ייעודי.

הטמעת GCKCastChannel.

- (NSInteger) loadMedia: (GCKMediaInformation *) mediaInfo

מתבצעת טעינה והתחלת הפעלה של פריט מדיה חדש.

Parameters

mediaInfo An object describing the media item to load.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay

טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition

טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
customData:	(id __nullable)	customData

טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
activeTrackIDs:	(NSArray< NSNumber * > *__nullable)	activeTrackIDs

טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
activeTrackIDs	An array of integers specifying the active tracks. May be `nil`.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) loadMedia:	(GCKMediaInformation *)	mediaInfo
autoplay:	(BOOL)	autoplay
playPosition:	(NSTimeInterval)	playPosition
activeTrackIDs:	(NSArray< NSNumber * > *__nullable)	activeTrackIDs
customData:	(id __nullable)	customData

טוענת, ובאופן אופציונלי מתחילה הפעלה של פריט מדיה חדש.

Parameters

mediaInfo	An object describing the media item to load.
autoplay	Whether playback should start immediately.
playPosition	The initial playback position.
activeTrackIDs	An array of integers specifying the active tracks. May be `nil`.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) setActiveTrackIDs: (NSArray< NSNumber * > *__nullable) activeTrackIDs

מגדירה את המסלולים הפעילים.

הבקשה תיכשל אם אין מצב מדיה נוכחי.

Parameters

activeTrackIDs An array of integers specifying the active tracks.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה. הפונקציה יכולה להיות nil או מערך ריק כדי להגדיר את המסלולים הפעילים לרשימה הריקה.

- (NSInteger) setTextTrackStyle: (GCKMediaTextTrackStyle *__nullable) textTrackStyle

מגדיר את סגנון רצועת הטקסט.

הבקשה תיכשל אם אין מצב מדיה נוכחי.

Parameters

textTrackStyle The text track style. The style will not be changed if this is nil.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) pause

השהיית ההפעלה של פריט המדיה הנוכחי.

הבקשה תיכשל אם אין מצב מדיה נוכחי.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) pauseWithCustomData: (id __nullable) customData

השהיית ההפעלה של פריט המדיה הנוכחי.

הבקשה תיכשל אם אין מצב מדיה נוכחי.

Parameters

customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) stop

מפסיק את ההפעלה של פריט המדיה הנוכחי.

הבקשה תיכשל אם אין מצב מדיה נוכחי. אם המערכת טוענת כרגע תור, הוא יוסר.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) stopWithCustomData: (id __nullable) customData

מפסיק את ההפעלה של פריט המדיה הנוכחי.

הבקשה תיכשל אם אין מצב מדיה נוכחי. אם המערכת טוענת כרגע תור, הוא יוסר.

Parameters

customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) play

מתחיל (או חוזר) הפעלה של פריט המדיה הנוכחי.

ההפעלה תמיד מתחילה בתחילת השידור. הבקשה תיכשל אם אין מצב מדיה נוכחי.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) playWithCustomData: (id __nullable) customData

מתחיל (או חוזר) הפעלה של פריט המדיה הנוכחי.

ההפעלה תמיד מתחילה בתחילת השידור. הבקשה תיכשל אם אין מצב מדיה נוכחי.

Parameters

customData Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or nil.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) seekToTimeInterval: (NSTimeInterval) position

חיפוש במיקום חדש בתוך פריט המדיה הנוכחי.

הבקשה תיכשל אם אין מצב מדיה נוכחי.

Parameters

position The new position from the beginning of the stream.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) seekToTimeInterval:	(NSTimeInterval)	position
resumeState:	(GCKMediaControlChannelResumeState)	resumeState

חיפוש במיקום חדש בתוך פריט המדיה הנוכחי.

הבקשה תיכשל אם אין מצב מדיה נוכחי.

Parameters

position	The new position interval from the beginning of the stream.
resumeState	The action to take after the seek operation has finished.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) seekToTimeInterval:	(NSTimeInterval)	position
resumeState:	(GCKMediaControlChannelResumeState)	resumeState
customData:	(id __nullable)	customData

חיפוש במיקום חדש בתוך פריט המדיה הנוכחי.

הבקשה תיכשל אם אין מצב מדיה נוכחי.

Parameters

position	The new position from the beginning of the stream.
resumeState	The action to take after the seek operation has finished.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) queueLoadItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
startIndex:	(NSUInteger)	startIndex
repeatMode:	(GCKMediaRepeatMode)	repeatMode

טוענת, ובאופן אופציונלי מתחילה הפעלה של תור חדש של פריטי מדיה.

Parameters

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
repeatMode	The repeat mode for playing the queue.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueLoadItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
startIndex:	(NSUInteger)	startIndex
repeatMode:	(GCKMediaRepeatMode)	repeatMode
customData:	(id __nullable)	customData

טוענת, ובאופן אופציונלי מתחילה הפעלה של תור חדש של פריטי מדיה.

Parameters

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
repeatMode	The repeat mode for playing the queue.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueLoadItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
startIndex:	(NSUInteger)	startIndex
playPosition:	(NSTimeInterval)	playPosition
repeatMode:	(GCKMediaRepeatMode)	repeatMode
customData:	(id __nullable)	customData

טוענת, ובאופן אופציונלי מתחילה הפעלה של תור חדש של פריטי מדיה.

Parameters

queueItems	An array of GCKMediaQueueItem instances to load. Must not be `nil` or empty.
startIndex	The index of the item in the items array that should be played first.
playPosition	The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
repeatMode	The repeat mode for playing the queue.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueInsertItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
beforeItemWithID:	(NSUInteger)	beforeItemID

הוספת רשימה של פריטי מדיה חדשים ל'הבאים בתור'.

Parameters

queueItems	An array of GCKMediaQueueItem instances to insert. Must not be `nil` or empty.
beforeItemID	The ID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID, the inserted list will be appended to the end of the queue.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueInsertItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
beforeItemWithID:	(NSUInteger)	beforeItemID
customData:	(id __nullable)	customData

הוספת רשימה של פריטי מדיה חדשים ל'הבאים בתור'.

Parameters

queueItems	An array of GCKMediaQueueItem instances to insert. Must not be `nil` or empty.
beforeItemID	ID of the item that will be located immediately after the inserted list. If the value is kGCKMediaQueueInvalidItemID, the inserted list will be appended to the end of the queue.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueInsertItem:	(GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID

שיטת נוחות שמכניסה פריט יחיד ל'הבאים בתור'.

Parameters

item	The item to insert.
beforeItemID	The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueInsertAndPlayItem:	(GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID

שיטת נוחות שמכניסה פריט יחיד ל'הבאים בתור' והופכת אותו לפריט הנוכחי.

Parameters

item	The item to insert.
beforeItemID	The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueInsertAndPlayItem:	(GCKMediaQueueItem *)	item
beforeItemWithID:	(NSUInteger)	beforeItemID
playPosition:	(NSTimeInterval)	playPosition
customData:	(id __nullable)	customData

שיטת נוחות שמכניסה פריט יחיד ל'הבאים בתור' והופכת אותו לפריט הנוכחי.

Parameters

item	The item to insert.
beforeItemID	The ID of the item that will be located immediately after the inserted item. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the inserted item will be appended to the end of the queue.
playPosition	The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueUpdateItems: (NSArray< GCKMediaQueueItem * > *) queueItems

התור מתעדכן.

Parameters

queueItems The list of updated items.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueUpdateItems:	(NSArray< GCKMediaQueueItem * > *)	queueItems
customData:	(id __nullable)	customData

התור מתעדכן.

Parameters

queueItems	The list of updated items.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueRemoveItemsWithIDs: (NSArray< NSNumber * > *) itemIDs

הסרת רשימה של פריטי מדיה מהתור.

אם כתוצאה מכך התור ריק, פעילות המדיה הנוכחית תסתיים.

Parameters

itemIDs An array of media item IDs identifying the items to remove. Must not be nil or empty.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueRemoveItemsWithIDs:	(NSArray< NSNumber * > *)	itemIDs
customData:	(id __nullable)	customData

הסרת רשימה של פריטי מדיה מהתור.

אם כתוצאה מכך התור ריק, פעילות המדיה הנוכחית תסתיים.

Parameters

itemIDs	An array of media item IDs identifying the items to remove. Must not be `nil` or empty.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueRemoveItemWithID: (NSUInteger) itemID

שיטת נוחות שמסירה פריט יחיד מ'הבאים בתור'.

Parameters

itemID The ID of the item to remove.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueReorderItemsWithIDs:	(NSArray< NSNumber * > *)	queueItemIDs
insertBeforeItemWithID:	(NSUInteger)	beforeItemID

שינוי הסדר של פריטי מדיה בתור.

Parameters

queueItemIDs	An array of media item IDs identifying the items to reorder. Must not be `nil` or empty.
beforeItemID	ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the reordered list will be appended at the end of the queue.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueReorderItemsWithIDs:	(NSArray< NSNumber * > *)	queueItemIDs
insertBeforeItemWithID:	(NSUInteger)	beforeItemID
customData:	(id __nullable)	customData

אפשר לשנות את הסדר של רשימת פריטי מדיה שנמצאים בתור.

Parameters

queueItemIDs	An array of media item IDs identifying the items to reorder. Must not be `nil` or empty.
beforeItemID	The ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the reordered list will be moved to the end of the queue.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueMoveItemWithID:	(NSUInteger)	itemID
beforeItemWithID:	(NSUInteger)	beforeItemID

שיטת נוחות שמזיזה פריט יחיד בתור.

Parameters

itemID	The ID of the item to move.
beforeItemID	The ID of the item that will be located immediately after the reordered list. If the value is kGCKMediaQueueInvalidItemID, or does not refer to any item currently in the queue, the item will be moved to the end of the queue.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) queueJumpToItemWithID: (NSUInteger) itemID

קופץ לפריט עם המזהה שצוין בתור.

Parameters

itemID The ID of the item to jump to.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) queueJumpToItemWithID:	(NSUInteger)	itemID
customData:	(id __nullable)	customData

קופץ לפריט עם המזהה שצוין בתור.

Parameters

itemID	The ID of the item to jump to.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) queueJumpToItemWithID:	(NSUInteger)	itemID
playPosition:	(NSTimeInterval)	playPosition
customData:	(id __nullable)	customData

קופץ לפריט עם המזהה שצוין בתור.

Parameters

itemID	The ID of the item to jump to.
playPosition	The initial playback position for the item when it is first played, relative to the beginning of the stream. This value is ignored when the same item is played again, for example when the queue repeats, or the item is later jumped to. In those cases the item's startTime is used.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) queueNextItem

מעבר לפריט הבא בתור.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) queuePreviousItem

מעבר לפריט הקודם בתור.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) queueSetRepeatMode: (GCKMediaRepeatMode) repeatMode

מגדיר את מצב החזרה של התור.

Parameters

repeatMode The new repeat mode.

החזרות: מזהה הבקשה של הבקשה הזו, או kGCKInvalidRequestID אם ההודעה לא נשלחה או אם הפרמטרים לא חוקיים.

- (NSInteger) setStreamVolume: (float) volume

מגדיר את עוצמת הקול של הסטרימינג.

הבקשה תיכשל אם אין סשן מדיה כרגע.

Parameters

volume The new volume, in the range [0.0 - 1.0].

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) setStreamVolume:	(float)	volume
customData:	(id __nullable)	customData

מגדיר את עוצמת הקול של הסטרימינג.

הבקשה תיכשל אם אין סשן מדיה כרגע.

Parameters

volume	The new volume, in the range [0.0 - 1.0].
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) setStreamMuted: (BOOL) muted

הגדרה זו קובעת אם הסטרימינג יושתק.

הבקשה תיכשל אם אין סשן מדיה כרגע.

Parameters

muted Whether the stream should be muted or unmuted.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) setStreamMuted:	(BOOL)	muted
customData:	(id __nullable)	customData

הגדרה זו קובעת אם הסטרימינג יושתק.

הבקשה תיכשל אם אין סשן מדיה כרגע.

Parameters

muted	Whether the stream should be muted or unmuted.
customData	Custom application-specific data to pass along with the request. Must either be an object that can be serialized to JSON using NSJSONSerialization, or `nil`.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSInteger) requestStatus

מבקש מהצד המקבל מידע עדכני על סטטוס המדיה.

החזרות: מזהה הבקשה, או kGCKInvalidRequestID אם לא ניתן לשלוח את ההודעה.

- (NSTimeInterval) approximateStreamPosition

מחזירה את המיקום המשוער של השידור כפי שמחושב מנתוני הסטרימינג האחרונים שהתקבלו, ואת זמן המעבר שחלף מאז העדכון הזה.

מחזירה 0 אם הערוץ לא מחובר, או אם לא מותקנת מדיה כרגע.

- (BOOL) cancelRequestWithID: (NSInteger) requestID

ביטול בקשה בתהליך.

ביטול בקשה אינו מונע את הפעלתה; היא פשוט מציינת שאפליקציית ההתקשרות אינה מעוניין עוד בתוצאות הבקשה, כך שכל מצב הקשור למעקב אחר הבקשה יימחק.

Parameters

requestID The ID of the request to cancel.

החזרות: YES אם הבקשה בוטלה או NO אם אין בקשה למעקב עם המזהה הנתון.

- (instancetype) initWithNamespace: (NSString *) protocolNamespace

מאתחל ייעודי.

בונה GCKCastChannel חדש עם מרחב השמות הנתון.

Parameters

protocolNamespace The namespace.

מיושם ב-GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *) message

מתקשרים כאשר מתקבלת הודעת טקסט בערוץ הזה.

הטמעת ברירת המחדל היא no-op.

Parameters

message The message.

- (BOOL) sendTextMessage: (NSString *) message

תישלח הודעת טקסט בערוץ.

Parameters

message The message.

החזרות: YES הצלחה או NO אם לא ניתן לשלוח את ההודעה (כי הערוץ לא מחובר או כי האחסון הזמני של ההודעות מלא מדי כרגע).

Deprecated:: יש להשתמש בקישור sendTextMessage:error: שמספק מידע מפורט על השגיאה.

- (BOOL) sendTextMessage:	(NSString *)	message
error:	(GCKError __nullable __nullable)	error

תישלח הודעת טקסט בערוץ.

Parameters

message	The message.
error	A pointer at which to store the error result. May be `nil`.

החזרות: YES הצלחה או NO אם לא ניתן לשלוח את ההודעה.

- (NSInteger) generateRequestID

יוצר מזהה בקשה להודעה חדשה.

החזרות: המזהה שנוצר, או kGCKInvalidRequestID אם הערוץ לא מחובר כרגע.

- (NSNumber * __nullable) generateRequestNumber

שיטת נוחות שמעטפת את התוצאה של generateRequestID ב-NSNumber.

החזרות: המזהה שנוצר, או nil אם הערוץ לא מחובר כרגע.

- (void) didConnect

התקשרות כשהערוץ מחובר. המשמעות היא שניתן להחליף עכשיו הודעות עם מכשיר CAST בערוץ הזה.

הטמעת ברירת המחדל היא no-op.

- (void) didDisconnect

בוצעה שיחה כאשר הערוץ הזה נותק. פירוש הדבר הוא שלא ניתן יותר להחליף הודעות עם מכשיר ה-CAST דרך הערוץ הזה.

הטמעת ברירת המחדל היא no-op.

פרטי הנכס

- (GCKMediaStatus*) mediaStatus

readnonatomicstrong

סטטוס המדיה של המדיה שנטענת כרגע, אם יש כזו. אחרת, nil.

- (NSTimeInterval) timeSinceLastMediaStatusUpdate

readnonatomicassign

משך הזמן שעבר מאז התקבל העדכון האחרון של סטטוס המדיה.

אם הבקשה לסטטוס נמצאת בשלבי ביצוע, הערך יהיה 0.

- (GCKError*) lastError

readnonatomiccopy

פרטי השגיאה מהבקשה האחרונה, אם הייתה כזו, או nil אם הבקשה האחרונה הושלמה בהצלחה.

- (id<GCKMediaControlChannelDelegate>) delegate

readwritenonatomicweak

בעל הגישה מקבל התראות על שינויים במצב הערוץ.

- (NSString*) protocolNamespace

readnonatomiccopyinherited

מרחב השמות של הערוץ.

- (BOOL) isConnected

readnonatomicassigninherited

סימון שמציין אם הערוץ מחובר כרגע.

- (GCKDeviceManager*) deviceManager

readnonatomicweakinherited

מנהל המכשיר שבאמצעותו רשום הערוץ הזה, אם יש כזה.

Deprecated:: אם הערוץ הזה לא היה רשום למחלקה GCKDeviceManager שהוצאה משימוש, הערך יהיה nil.

מחלקת GCKMediaControlChannel

סקירה כללית

סיכום של שיטת המכונה

סיכום הנכס

פרטי השיטה

פרטי הנכס