Présentation

Sous-classe GCKCastChannel pour les opérations de contrôle multimédia.

Toutes les opérations qui s'appliquent à un flux actuellement actif (lecture, pause, recherche, arrêt, etc.) nécessitent un état du contenu multimédia valide (c'est-à-dire non nul). Sinon, elles renvoient kGCKInvalidRequestID et n'envoient pas la requête. L'état du contenu multimédia est demandé automatiquement lorsque la chaîne se connecte. Il est inclus dans une réponse de chargement réussi et peut également être mis à jour à tout moment. L'état du contenu multimédia peut également devenir nul à tout moment, par exemple si la chaîne est temporairement déconnectée. Lorsque vous utilisez ce canal, les modifications de l'état du contenu multimédia doivent être surveillées via le rappel mediaControlChannelDidUpdateStatus: (GCKMediaControlChannelDelegate-p). Les méthodes qui agissent sur les flux ne doivent être appelées que lorsque l'état du contenu multimédia n'est pas nul.

Si une requête est lancée avec succès, la méthode correspondante renvoie l'ID de requête qui lui a été attribué. Si la requête ne parvient pas à démarrer, la méthode renvoie kGCKInvalidRequestID et définit la propriété lastError pour indiquer la raison de l'échec. Si une requête est lancée avec succès, mais échoue finalement, le rappel mediaControlChannel:requestDidFailWithID:error: (GCKMediaControlChannelDelegate-p) est appelé pour indiquer l'échec.

Consultez GCKMediaControlChannelDelegate pour le protocole de délégué.

Deprecated:: Utilisez la propriété GCKRemoteMediaClient de GCKCastSession pour contrôler la lecture du contenu multimédia.

Hérite de GCKCastChannel.

Récapitulatif des méthodes d'instance
(instancetype)	- init
	Initialiseur désigné. Plus

(NSInteger)	- loadMedia:
	Charge et lance la lecture d'un nouvel élément multimédia. Plus

(NSInteger)	- loadMedia:autoplay:
	Charge et lance éventuellement la lecture d'un nouvel élément multimédia. Plus

(NSInteger)	- loadMedia:autoplay:playPosition:
	Charge et lance éventuellement la lecture d'un nouvel élément multimédia. Plus

(NSInteger)	- loadMedia:autoplay:playPosition:customData:
	Charge et lance éventuellement la lecture d'un nouvel élément multimédia. Plus

(NSInteger)	- loadMedia:autoplay:playPosition:activeTrackIDs:
	Charge et lance éventuellement la lecture d'un nouvel élément multimédia. Plus

(NSInteger)	- loadMedia:autoplay:playPosition:activeTrackIDs:customData:
	Charge et lance éventuellement la lecture d'un nouvel élément multimédia. Plus

(NSInteger)	- setActiveTrackIDs:
	Définit les pistes actives. Plus

(NSInteger)	- setTextTrackStyle:
	Définit le style de la piste de texte. Plus

(NSInteger)	- pause
	Met en pause la lecture de l'élément multimédia actuel. Plus

(NSInteger)	- pauseWithCustomData:
	Met en pause la lecture de l'élément multimédia actuel. Plus

(NSInteger)	- stop
	Arrête la lecture de l'élément multimédia en cours. Plus

(NSInteger)	- stopWithCustomData:
	Arrête la lecture de l'élément multimédia en cours. Plus

(NSInteger)	- play
	Démarre (ou reprend) la lecture de l'élément multimédia actuel. Plus

(NSInteger)	- playWithCustomData:
	Démarre (ou reprend) la lecture de l'élément multimédia actuel. Plus

(NSInteger)	- seekToTimeInterval:
	Recherche une nouvelle position dans l'élément multimédia actuel. Plus

(NSInteger)	- seekToTimeInterval:resumeState:
	Recherche une nouvelle position dans l'élément multimédia actuel. Plus

(NSInteger)	- seekToTimeInterval:resumeState:customData:
	Recherche une nouvelle position dans l'élément multimédia actuel. Plus

(NSInteger)	- queueLoadItems:startIndex:repeatMode:
	Charge et lance éventuellement la lecture d'une nouvelle file d'attente d'éléments multimédias. Plus

(NSInteger)	- queueLoadItems:startIndex:repeatMode:customData:
	Charge et lance éventuellement la lecture d'une nouvelle file d'attente d'éléments multimédias. Plus

(NSInteger)	- queueLoadItems:startIndex:playPosition:repeatMode:customData:
	Charge et lance éventuellement la lecture d'une nouvelle file d'attente d'éléments multimédias. Plus

(NSInteger)	- queueInsertItems:beforeItemWithID:
	Insère une liste de nouveaux éléments multimédias dans la file d'attente. Plus

(NSInteger)	- queueInsertItems:beforeItemWithID:customData:
	Insère une liste de nouveaux éléments multimédias dans la file d'attente. Plus

(NSInteger)	- queueInsertItem:beforeItemWithID:
	Méthode pratique qui insère un seul élément dans la file d'attente. Plus

(NSInteger)	- queueInsertAndPlayItem:beforeItemWithID:
	Méthode pratique qui insère un seul élément dans la file d'attente et en fait l'élément actuel. Plus

(NSInteger)	- queueInsertAndPlayItem:beforeItemWithID:playPosition:customData:
	Méthode pratique qui insère un seul élément dans la file d'attente et en fait l'élément actuel. Plus

(NSInteger)	- queueUpdateItems:
	Met à jour la file d'attente. Plus

(NSInteger)	- queueUpdateItems:customData:
	Met à jour la file d'attente. Plus

(NSInteger)	- queueRemoveItemsWithIDs:
	Supprime une liste d'éléments multimédias de la file d'attente. Plus

(NSInteger)	- queueRemoveItemsWithIDs:customData:
	Supprime une liste d'éléments multimédias de la file d'attente. Plus

(NSInteger)	- queueRemoveItemWithID:
	Méthode pratique qui supprime un seul élément de la file d'attente. Plus

(NSInteger)	- queueReorderItemsWithIDs:insertBeforeItemWithID:
	Réorganise une liste d'éléments multimédias dans la file d'attente. Plus

(NSInteger)	- queueReorderItemsWithIDs:insertBeforeItemWithID:customData:
	Réorganisez une liste d'éléments multimédias dans la file d'attente. Plus

(NSInteger)	- queueMoveItemWithID:beforeItemWithID:
	Méthode pratique qui déplace un seul élément dans la file d'attente. Plus

(NSInteger)	- queueJumpToItemWithID:
	Renvoie à l'élément dont l'ID est spécifié dans la file d'attente. Plus

(NSInteger)	- queueJumpToItemWithID:customData:
	Renvoie à l'élément dont l'ID est spécifié dans la file d'attente. Plus

(NSInteger)	- queueJumpToItemWithID:playPosition:customData:
	Renvoie à l'élément dont l'ID est spécifié dans la file d'attente. Plus

(NSInteger)	- queueNextItem
	Passer à l'élément suivant de la file d'attente Plus

(NSInteger)	- queuePreviousItem
	Passe à l'élément précédent de la file d'attente. Plus

(NSInteger)	- queueSetRepeatMode:
	Définit le mode de répétition de la file d'attente. Plus

(NSInteger)	- setStreamVolume:
	Règle le volume du flux. Plus

(NSInteger)	- setStreamVolume:customData:
	Règle le volume du flux. Plus

(NSInteger)	- setStreamMuted:
	Indique si le flux est coupé. Plus

(NSInteger)	- setStreamMuted:customData:
	Indique si le flux est coupé. Plus

(NSInteger)	- requestStatus
	Demande des informations mises à jour sur l'état du contenu multimédia au récepteur. Plus

(NSTimeInterval)	- approximateStreamPosition
	Renvoie la position approximative du flux, calculée à partir des dernières informations reçues sur le flux et du temps écoulé depuis cette mise à jour. Plus

(BOOL)	- cancelRequestWithID:
	Annule une demande en cours. Plus

(instancetype)	- initWithNamespace:
	Initialiseur désigné. Plus

(void)	- didReceiveTextMessage:
	Appelée lorsqu'un message texte a été reçu sur ce canal. Plus

(BOOL)	- sendTextMessage:
	Envoie un message sur ce canal. Plus

(BOOL)	- sendTextMessage:error:
	Envoie un message sur ce canal. Plus

(NSInteger)	- generateRequestID
	Génère un ID de requête pour un nouveau message. Plus

(NSNumber *__nullable)	- generateRequestNumber
	Méthode pratique qui encapsule le résultat de generateRequestID dans un NSNumber. Plus

(void)	- didConnect
	Appelé lorsque ce canal a été connecté, ce qui indique que des messages peuvent désormais être échangés avec l'appareil Cast sur ce canal. Plus

(void)	- didDisconnect
	Appelé lorsque ce canal a été déconnecté, ce qui indique que les messages ne peuvent plus être échangés avec l'appareil Cast sur ce canal. Plus

Récapitulatif des propriétés
GCKMediaStatus *	mediaStatus
	État du contenu multimédia actuellement chargé, le cas échéant. Sinon, `nil`. Plus

NSTimeInterval	timeSinceLastMediaStatusUpdate
	Temps écoulé depuis la dernière mise à jour de l'état du contenu multimédia. Plus

GCKError *	lastError
	Détails de l'erreur de la dernière requête, le cas échéant, ou `nil` si la dernière requête a abouti. Plus

id< GCKMediaControlChannelDelegate >	delegate
	Délégué pour la réception des notifications concernant les modifications de l'état du canal. Plus

NSString *	protocolNamespace
	Espace de noms du canal. Plus

BOOL	isConnected
	Indicateur indiquant si cette chaîne est actuellement associée. Plus

GCKDeviceManager *	deviceManager
	Gestionnaire d'appareils auprès duquel cette chaîne est enregistrée, le cas échéant. Plus

Détails sur la méthode

- (instancetype) init

Initialiseur désigné.

Implémente GCKCastChannel.

- (NSInteger) loadMedia: (GCKMediaInformation *) mediaInfo

Charge et lance la lecture d'un nouvel élément multimédia.

Parameters

mediaInfo An object describing the media item to load.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Charge et lance éventuellement la lecture d'un nouvel élément multimédia.

Parameters

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

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Charge et lance éventuellement la lecture d'un nouvel élément multimédia.

Parameters

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

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Charge et lance éventuellement la lecture d'un nouvel élément multimédia.

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`.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Charge et lance éventuellement la lecture d'un nouvel élément multimédia.

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`.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Charge et lance éventuellement la lecture d'un nouvel élément multimédia.

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`.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Définit les pistes actives.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

Parameters

activeTrackIDs An array of integers specifying the active tracks.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé. Peut être nil ou un tableau vide pour définir les pistes actives sur la liste vide.

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

Définit le style de la piste de texte.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

Parameters

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

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) pause

Met en pause la lecture de l'élément multimédia actuel.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) pauseWithCustomData: (id __nullable) customData

Met en pause la lecture de l'élément multimédia actuel.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

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.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) stop

Arrête la lecture de l'élément multimédia en cours.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible. Si une file d'attente est actuellement chargée, elle est supprimée.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) stopWithCustomData: (id __nullable) customData

Arrête la lecture de l'élément multimédia en cours.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible. Si une file d'attente est actuellement chargée, elle est supprimée.

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.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) play

Démarre (ou reprend) la lecture de l'élément multimédia actuel.

La lecture commence toujours au début du flux. La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) playWithCustomData: (id __nullable) customData

Démarre (ou reprend) la lecture de l'élément multimédia actuel.

La lecture commence toujours au début du flux. La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

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.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) seekToTimeInterval: (NSTimeInterval) position

Recherche une nouvelle position dans l'élément multimédia actuel.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

Parameters

position The new position from the beginning of the stream.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Recherche une nouvelle position dans l'élément multimédia actuel.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

Parameters

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

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Recherche une nouvelle position dans l'élément multimédia actuel.

La requête échouera si aucun état du contenu multimédia actuel n'est disponible.

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`.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Charge et lance éventuellement la lecture d'une nouvelle file d'attente d'éléments multimédias.

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.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Charge et lance éventuellement la lecture d'une nouvelle file d'attente d'éléments multimédias.

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`.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Charge et lance éventuellement la lecture d'une nouvelle file d'attente d'éléments multimédias.

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`.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Insère une liste de nouveaux éléments multimédias dans la file d'attente.

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.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Insère une liste de nouveaux éléments multimédias dans la file d'attente.

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`.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Méthode pratique qui insère un seul élément dans la file d'attente.

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.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Méthode pratique qui insère un seul élément dans la file d'attente et en fait l'élément actuel.

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.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Méthode pratique qui insère un seul élément dans la file d'attente et en fait l'élément actuel.

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`.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Met à jour la file d'attente.

Parameters

queueItems The list of updated items.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Met à jour la file d'attente.

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`.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Supprime une liste d'éléments multimédias de la file d'attente.

Si la file d'attente se vide, la session multimédia en cours se termine.

Parameters

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

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Supprime une liste d'éléments multimédias de la file d'attente.

Si la file d'attente se vide, la session multimédia en cours se termine.

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`.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

- (NSInteger) queueRemoveItemWithID: (NSUInteger) itemID

Méthode pratique qui supprime un seul élément de la file d'attente.

Parameters

itemID The ID of the item to remove.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Réorganise une liste d'éléments multimédias dans la file d'attente.

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.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Réorganisez une liste d'éléments multimédias dans la file d'attente.

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`.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

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

Méthode pratique qui déplace un seul élément dans la file d'attente.

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.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

- (NSInteger) queueJumpToItemWithID: (NSUInteger) itemID

Renvoie à l'élément dont l'ID est spécifié dans la file d'attente.

Parameters

itemID The ID of the item to jump to.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Renvoie à l'élément dont l'ID est spécifié dans la file d'attente.

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`.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Renvoie à l'élément dont l'ID est spécifié dans la file d'attente.

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`.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) queueNextItem

Passer à l'élément suivant de la file d'attente

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) queuePreviousItem

Passe à l'élément précédent de la file d'attente.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) queueSetRepeatMode: (GCKMediaRepeatMode) repeatMode

Définit le mode de répétition de la file d'attente.

Parameters

repeatMode The new repeat mode.

Renvoie: ID de la requête, ou kGCKInvalidRequestID si le message n'a pas pu être envoyé ou si l'un des paramètres n'est pas valide.

- (NSInteger) setStreamVolume: (float) volume

Règle le volume du flux.

La requête échouera s'il n'y a pas de session multimédia en cours.

Parameters

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

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Règle le volume du flux.

La requête échouera s'il n'y a pas de session multimédia en cours.

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`.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) setStreamMuted: (BOOL) muted

Indique si le flux est coupé.

La requête échouera s'il n'y a pas de session multimédia en cours.

Parameters

muted Whether the stream should be muted or unmuted.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

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

Indique si le flux est coupé.

La requête échouera s'il n'y a pas de session multimédia en cours.

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`.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSInteger) requestStatus

Demande des informations mises à jour sur l'état du contenu multimédia au récepteur.

Renvoie: ID de la requête ou kGCKInvalidRequestID si le message n'a pas pu être envoyé.

- (NSTimeInterval) approximateStreamPosition

Renvoie la position approximative du flux, calculée à partir des dernières informations reçues sur le flux et du temps écoulé depuis cette mise à jour.

Renvoie 0 si la chaîne n'est pas connectée ou si aucun contenu multimédia n'est actuellement chargé.

- (BOOL) cancelRequestWithID: (NSInteger) requestID

Annule une demande en cours.

L'annulation d'une requête n'empêche pas son exécution. Elle indique simplement que l'application appelante n'est plus intéressée par les résultats de la requête. Tout état associé au suivi de la requête sera donc effacé.

Parameters

requestID The ID of the request to cancel.

Renvoie: YES si la requête a été annulée, ou NO si aucune requête n'est suivie avec l'ID donné.

- (instancetype) initWithNamespace: (NSString *) protocolNamespace

Initialiseur désigné.

Construit un nouveau GCKCastChannel avec l'espace de noms donné.

Parameters

protocolNamespace The namespace.

Implémenté dans GCKGenericChannel.

- (void) didReceiveTextMessage: (NSString *) message

Appelée lorsqu'un message texte a été reçu sur ce canal.

L'implémentation par défaut est no-op.

Parameters

message The message.

- (BOOL) sendTextMessage: (NSString *) message

Envoie un message sur ce canal.

Parameters

message The message.

Renvoie: YES en cas de succès ou NO si le message n'a pas pu être envoyé (parce que le canal n'est pas connecté ou parce que la mémoire tampon d'envoi est trop pleine pour le moment).

Deprecated:: Utilisez sendTextMessage:error:, qui fournit des informations détaillées sur les erreurs.

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

Envoie un message sur ce canal.

Parameters

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

Renvoie: YES en cas de réussite ou NO si le message n'a pas pu être envoyé.

- (NSInteger) generateRequestID

Génère un ID de requête pour un nouveau message.

Renvoie: ID généré ou kGCKInvalidRequestID si la chaîne n'est pas connectée actuellement.

- (NSNumber * __nullable) generateRequestNumber

Méthode pratique qui encapsule le résultat de generateRequestID dans un NSNumber.

Renvoie: ID généré ou nil si la chaîne n'est pas connectée actuellement.

- (void) didConnect

Appelé lorsque ce canal a été connecté, ce qui indique que des messages peuvent désormais être échangés avec l'appareil Cast sur ce canal.

L'implémentation par défaut est no-op.

- (void) didDisconnect

Appelé lorsque ce canal a été déconnecté, ce qui indique que les messages ne peuvent plus être échangés avec l'appareil Cast sur ce canal.

L'implémentation par défaut est no-op.

Détails de la propriété

- (GCKMediaStatus*) mediaStatus

readnonatomicstrong

État du contenu multimédia actuellement chargé, le cas échéant. Sinon, nil.

- (NSTimeInterval) timeSinceLastMediaStatusUpdate

readnonatomicassign

Temps écoulé depuis la dernière mise à jour de l'état du contenu multimédia.

Si une demande d'état est en cours, cette valeur sera égale à 0.

- (GCKError*) lastError

readnonatomiccopy

Détails de l'erreur de la dernière requête, le cas échéant, ou nil si la dernière requête a abouti.

- (id<GCKMediaControlChannelDelegate>) delegate

readwritenonatomicweak

Délégué pour la réception des notifications concernant les modifications de l'état du canal.

- (NSString*) protocolNamespace

readnonatomiccopyinherited

Espace de noms du canal.

- (BOOL) isConnected

readnonatomicassigninherited

Indicateur indiquant si cette chaîne est actuellement associée.

- (GCKDeviceManager*) deviceManager

readnonatomicweakinherited

Gestionnaire d'appareils auprès duquel cette chaîne est enregistrée, le cas échéant.

Deprecated:: Si cette chaîne n'a pas été enregistrée avec la classe GCKDeviceManager obsolète, la valeur sera nil.

Classe GCKMediaControlChannel Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Présentation

Récapitulatif des méthodes d'instance

Récapitulatif des propriétés

Détails sur la méthode

Détails de la propriété

Classe GCKMediaControlChannel