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:
GCKCastChannelist als abgeleitete Klasse gedacht, um nicht einfache Kanäle mit zugehörigem Bundesstaat zu implementieren.GCKGenericChannelwird 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.