Werbeunterbrechungen
Das iOS Sender SDK unterstützt Werbeunterbrechungen und Companion-Anzeigen in einem bestimmten Medienstream.
Weitere Informationen zur Funktionsweise von Werbeunterbrechungen findest du in der Übersicht zu Werbeunterbrechungen im Webempfänger.
Pausen können zwar sowohl auf dem Sender als auch auf dem Empfänger festgelegt werden, es wird jedoch empfohlen, sie auf dem Webempfänger und dem Android TV-Empfänger festzulegen, um ein einheitliches Verhalten auf allen Plattformen zu gewährleisten.
Unter iOS geben Sie Werbeunterbrechungen in einem Ladebefehl mit GCKAdBreakClipInfo
und GCKAdBreakInfo
an:
let breakClip1Builder = GCKAdBreakClipInfoBuilder(adBreakClipID: "bc0") breakClip1Builder.title = "Clip title" if let posterUrl = URL(string: "https://www.some.url") { breakClip1Builder.posterURL = posterUrl } breakClip1Builder.duration = 60 breakClip1Builder.whenSkippable = 5 // Set this field so that the ad is skippable let breakClip1 = breakClip1Builder.build() let breakClip2 = ... let breakClip3 = ... let break1 = GCKAdBreakInfoBuilder(adBreakID: "b0", adBreakClipIds: ["bc0", "bc1", "bc2"]).build() let mediaInfoBuilder = GCKMediaInformationBuilder(entity: "entity") ... mediaInfoBuilder.adBreaks = [break1] mediaInfoBuilder.adBreakClips = [breakClip1, breakClip2, breakClip3] ... mediaInformation = mediaInfoBuilder.build() let mediaLoadRequestDataBuilder = GCKMediaLoadRequestDataBuilder() mediaLoadRequestDataBuilder.mediaInformation = mediaInformation sessionManager.currentSession?.remoteMediaClient?.loadMedia(with: mediaLoadRequestDataBuilder.build())
GCKAdBreakClipInfoBuilder *breakClipInfoBuilder = [[GCKAdBreakClipInfoBuilder alloc] initWithAdBreakClipID:@"bc0"]; breakClipInfoBuilder.title = @"Clip title"; breakClipInfoBuilder.posterURL = [[NSURL alloc] initWithString:@"https://www.some.url"]; breakClipInfoBuilder.duration = 60; breakClipInfoBuilder.whenSkippable = 5; GCKAdBreakClipInfo *breakClip1 = breakClipInfoBuilder.build; GCKAdBreakClipInfo *breakClip2 = ... GCKAdBreakClipInfo *breakClip3 = ... GCKAdBreakInfo *break1 = [[GCKAdBreakInfoBuilder alloc] initWithAdBreakID:@"b0" adBreakClipIds:@[@"bc0", @"bc1", @"bc2"]].build; GCKMediaInformationBuilder *mediaInfoBuilder = [[GCKMediaInformationBuilder alloc] initWithEntity:@"entity"]; ... mediaInfoBuilder.adBreaks = @[break1]; mediaInfoBuilder.adBreakClips = @[breakClip1, breakClip2, breakClip3]; ... self.mediaInformation = [mediaInfoBuilder build]; GCKMediaLoadRequestDataBuilder *mediaLoadRequestDataBuilder = [[GCKMediaLoadRequestDataBuilder alloc] init]; mediaLoadRequestDataBuilder.mediaInformation = self.mediaInformation; // Send a load request to the remote media client. GCKRequest *request = [self.sessionManager.currentSession.remoteMediaClient loadMediaWithLoadRequestData:[mediaLoadRequestDataBuilder build]];
Variable Wiedergabegeschwindigkeit
Ihre App kann die Wiedergabegeschwindigkeit für das aktuelle Medienelement anzeigen und ändern.
Du kannst die Wiedergabegeschwindigkeit mit -[setPlaybackRate:]
oder -[setPlaybackRate:customData:]
des GCKRemoteMediaClient
festlegen, mit playbackRateController
von GCKUIMediaController
auf GCKUIPlaybackRateController
zugreifen und die aktuelle Wiedergabegeschwindigkeit mit playbackRate
von GCKUIPlaybackRateController
anzeigen.
Beispielcode
In den folgenden beiden Dateien wird GCKUIPlaybackRateController
implementiert, das die Wiedergaberate über ein segmentiertes Steuerelement mit Schaltflächen für „normal“, „halbe Geschwindigkeit“ und „doppelte Geschwindigkeit“ steuert:
import GoogleCast /** * An implementation of GCKUIPlaybackRateController that controls playback rate * using a segmented control that has "normal", "half speed", and "double speed" * buttons. */ class SegmentedButtonPlaybackRateController: GCKUIPlaybackRateController { static let kSegmentNormal = 0; static let kSegmentHalfSpeed = 1; static let kSegmentDoubleSpeed = 2; var segmentedControl: UISegmentedControl! override var playbackRate: Float { didSet { var buttonIndex = 0 // Map the playback rate to one of our three supported speeds. if playbackRate == 1.0 { buttonIndex = SegmentedButtonPlaybackRateController.kSegmentNormal } else if playbackRate < 1.0 { buttonIndex = SegmentedButtonPlaybackRateController.kSegmentHalfSpeed } else { buttonIndex = SegmentedButtonPlaybackRateController.kSegmentDoubleSpeed } segmentedControl?.selectedSegmentIndex = buttonIndex } } override var inputEnabled: Bool { didSet { segmentedControl?.isEnabled = inputEnabled } } /** * Designated initializer. * * @param segmentedControl The segmented control for changing/displaying the * playback rate. */ convenience init(_ segmentedControl: UISegmentedControl) { self.init() self.segmentedControl = segmentedControl; segmentedControl.addTarget(self, action: #selector(segmentedControlTapped(sender:)), for: UIControl.Event.valueChanged) } @objc func segmentedControlTapped(sender: UISegmentedControl) { var playbackRate: Float = 1.0 switch segmentedControl?.selectedSegmentIndex { case SegmentedButtonPlaybackRateController.kSegmentHalfSpeed: playbackRate = 0.5; case SegmentedButtonPlaybackRateController.kSegmentDoubleSpeed: playbackRate = 2.0; case SegmentedButtonPlaybackRateController.kSegmentNormal: fallthrough default: playbackRate = 1.0; } self.playbackRate = playbackRate } }
SegmentedButtonPlaybackRateController.h
#import <GoogleCast/GoogleCast.h> #import <UIKit/UIKit.h> /** * An implementation of GCKUIPlaybackRateController that controls playback rate * using a segmented control that has "normal", "half speed", and "double speed" * buttons. */ @interface SegmentedButtonPlaybackRateController : GCKUIPlaybackRateController /** * Designated initializer. * * @param segmentedControl The segmented control for changing/displaying the * playback rate. */ - (instancetype)initWithSegmentedControl:(UISegmentedControl *)segmentedControl; @end
SegmentedButtonPlaybackRateController.m
#import "SegmentedButtonPlaybackRateController.h" @interface SegmentedButtonPlaybackRateController () { UISegmentedControl *_segmentedControl; } @end static const NSInteger kSegmentNormal = 0; static const NSInteger kSegmentHalfSpeed = 1; static const NSInteger kSegmentDoubleSpeed = 2; @implementation SegmentedButtonPlaybackRateController - (instancetype)initWithSegmentedControl:(UISegmentedControl *)segmentedControl { if (self = [super init]) { _segmentedControl = segmentedControl; [_segmentedControl addTarget:self action:@selector(segmentedControlTapped:) forControlEvents:UIControlEventValueChanged]; } return self; } - (void)setPlaybackRate:(float)playbackRate { [super setPlaybackRate:playbackRate]; NSInteger buttonIndex = 0; // Map the playback rate to one of our three supported speeds. if (playbackRate == 1.0) { buttonIndex = kSegmentNormal; } else if (playbackRate < 1.0) { buttonIndex = kSegmentHalfSpeed; } else { buttonIndex = kSegmentDoubleSpeed; } _segmentedControl.selectedSegmentIndex = buttonIndex; } - (void)setInputEnabled:(BOOL)inputEnabled { _segmentedControl.enabled = inputEnabled; [super setInputEnabled:inputEnabled]; } - (void)segmentedControlTapped:(id)sender { float playbackRate; switch (_segmentedControl.selectedSegmentIndex) { case kSegmentHalfSpeed: playbackRate = 0.5; break; case kSegmentDoubleSpeed: playbackRate = 2.0; break; case kSegmentNormal: default: playbackRate = 1.0; break; } self.playbackRate = playbackRate; } @end
Benutzerdefinierten Channel hinzufügen
Das Cast-Framework bietet zwei Möglichkeiten zum Erstellen eines Kanals zum Senden benutzerdefinierter Nachrichten an einen Webempfänger:
GCKCastChannel
ist als abgeleitete Klasse gedacht, um nicht einfache Kanäle mit zugehörigem Bundesstaat zu implementieren.GCKGenericChannel
wird als Alternative zum Erstellen von Unterklassen bereitgestellt. Die empfangenen Nachrichten werden an einen Bevollmächtigten übergeben, damit sie an anderer Stelle verarbeitet werden können.
Hier ein Beispiel für eine GCKCastChannel
-Implementierung:
class HGCTextChannel: GCKCastChannel { override func didReceiveTextMessage(_ message: String) { print("received message: \(message)") } }
HGCTextChannel.h
#import <GoogleCast/GCKCastChannel.h> @interface HGCTextChannel : GCKCastChannel @end
HGCTextChannel.m
#import "HGCTextChannel.h" @implementation HGCTextChannel - (void)didReceiveTextMessage:(NSString*)message { NSLog(@"received message: %@", message); } @end
Ein Kanal kann jederzeit registriert werden. Wenn die Sitzung derzeit nicht verbunden ist, wird der Kanal automatisch verbunden, sobald die Sitzung selbst verbunden ist. Voraussetzung ist, dass der Namespace des Kanals in der Metadatenliste der unterstützten Namespaces der Web Receiver-App enthalten ist.
Jeder benutzerdefinierte Channel wird durch einen eindeutigen Namespace definiert und muss mit dem Präfix urn:x-cast:
beginnen, z. B. urn:x-cast:com.example.custom
. Sie können mehrere benutzerdefinierte Channels mit jeweils einem eigenen Namespace haben. Die Web Receiver-Anwendung kann auch Nachrichten mit demselben Namespace senden und empfangen.
var error: GCKError? let textChannel = HGCTextChannel.init(namespace: "urn:x-cast:com.google.cast.sample.helloworld") sessionManager.currentCastSession?.add(textChannel) textChannel.sendTextMessage("Hello World", error: &error) if error != nil { print("Error sending text message \(error.debugDescription)") }
NSError *error; HGCTextChannel *textChannel = [[HGCTextChannel alloc] initWithNamespace:@"urn:x-cast:com.google.cast.sample.helloworld"]; [sessionManager.currentCastSession addChannel:textChannel]; [textChannel sendTextMessage:@"Hello World" error:&error]; if (error != nil) { NSLog(@"Error sending text message: %@", error); }
Wenn Sie eine Logik bereitstellen möchten, die ausgeführt werden muss, wenn ein bestimmter Kanal verbunden oder getrennt wird, überschreiben Sie die Methoden -[didConnect]
und -[didDisconnect]
, wenn Sie GCKCastChannel
verwenden, oder Implementierungen für die Methoden -[castChannelDidConnect:]
und -[castChannelDidDisconnect:]
der GCKGenericChannelDelegate
, wenn GCKGenericChannel
verwendet wird.
Unterstützung von Autoplay
Siehe Autoplay- und Queueing-APIs.
Bildauswahl und Caching überschreiben
Verschiedene Komponenten des Frameworks (z. B. das Cast-Dialogfeld, der Mini-Controller, der maximierte Controller und ggf. die GCKUIMediaController
) zeigen das Artwork für die aktuell gestreamten Medien an. Die URLs zu den Grafiken sind in der Regel im GCKMediaMetadata
für die Medien enthalten. Die Sender-App kann jedoch auch eine alternative Quelle für die URLs haben.
Das Protokoll GCKUIImagePicker
definiert eine Methode zur Auswahl eines geeigneten Bildes für eine bestimmte Nutzung und gewünschte Größe. Es hat eine einzelne Methode, -[getImageWithHints:fromMetadata:]
, die ein GCKUIImageHints
-Objekt und ein GCKMediaMetadata
-Objekt als Parameter verwendet und als Ergebnis ein GCKImage
-Objekt zurückgibt. Das Framework stellt eine Standardimplementierung von GCKUIImagePicker
bereit, mit der immer das erste Bild in der Liste der Images im GCKMediaMetadata
-Objekt ausgewählt wird. Die Anwendung kann aber auch eine alternative Implementierung bereitstellen. Dazu wird das Attribut imagePicker
des Singleton-Elements GCKCastContext
festgelegt.
Das Protokoll GCKUIImageCache
definiert auch eine Methode zum Caching von Bildern, die vom Framework mit HTTPS heruntergeladen werden. Das Framework bietet eine Standardimplementierung von GCKUIImageCache
, die heruntergeladene Bilddateien im Cache-Verzeichnis der Anwendung speichert. Die Anwendung kann jedoch auch eine alternative Implementierung bereitstellen, indem die Eigenschaft imageCache
des Singleton-Elements GCKCastContext
festgelegt wird.
Nächste Schritte
Damit sind die Funktionen abgeschlossen, die Sie der Sender-App in iOS hinzufügen können. Sie können jetzt eine Sender-App für eine andere Plattform (Android oder Web) oder einen Webempfänger erstellen.