Werbeunterbrechungen
Das iOS Sender SDK unterstützt Werbeunterbrechungen und Companion-Anzeigen innerhalb eines bestimmten Mediastreams.
Weitere Informationen zur Funktionsweise von Werbeunterbrechungen finden Sie in der Übersicht zu Werbeunterbrechungen bei Webempfängern.
Pausen können zwar sowohl beim Sender als auch beim Empfänger angegeben werden. Es wird jedoch empfohlen, diese auf Web Receiver und Android TV Receiver anzugeben, um ein einheitliches Verhalten auf allen Plattformen aufrechtzuerhalten.
Auf iOS-Geräten 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 Wiedergaberate
Deine App kann die Wiedergabegeschwindigkeit für das aktuelle Medienelement anzeigen und ändern.
Du kannst die Geschwindigkeit mit -[setPlaybackRate:] oder -[setPlaybackRate:customData:] von GCKRemoteMediaClient festlegen, mit playbackRateController des GCKUIMediaController auf GCKUIPlaybackRateController zugreifen und die aktuelle Wiedergaberate mit playbackRate von GCKUIPlaybackRateController aufrufen.
Beispielcode
Die folgenden beiden Dateien implementieren GCKUIPlaybackRateController, das die Wiedergaberate mithilfe einer segmentierten Steuerung mit Schaltflächen für normale, halbe 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 für die Implementierung von nicht trivialen Kanälen gedacht, die einen verknüpften Bundesstaat haben.GCKGenericChannelwird als Alternative zur Erstellung von abgeleiteten Klassen 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 sich die Sitzung derzeit nicht in einem verbundenen Zustand befindet, 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 eindeutigen Namespace verwenden. Die Web Receiver-Anwendung kann über denselben Namespace auch Nachrichten 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 du Logik bereitstellen möchtest, die ausgeführt werden muss, wenn ein bestimmter Kanal verbunden oder getrennt wird, kannst du die Methoden -[didConnect] und -[didDisconnect] überschreiben, wenn du GCKCastChannel verwendest, oder Implementierungen für die Methoden -[castChannelDidConnect:] und -[castChannelDidDisconnect:] der Methode GCKGenericChannelDelegate bereitstellen, wenn du GCKGenericChannel verwendest.
Autoplay unterstützen
Siehe Autoplay- und Warteschlangen-APIs.
Bildauswahl und Caching überschreiben
Verschiedene Komponenten des Frameworks, d. h. das Cast-Dialogfeld, der Mini-Controller, der erweiterte Controller und der GCKUIMediaController, falls konfiguriert, zeigen das Artwork für die aktuell gestreamten Medien an. Die URLs zu den Bild-Artwork sind normalerweise in der GCKMediaMetadata für die Medien enthalten. Die Absender-App kann aber auch eine alternative Quelle für die URLs haben.
Das GCKUIImagePicker-Protokoll definiert eine Möglichkeit, ein geeignetes Image für eine bestimmte Nutzung und gewünschte Größe auszuwählen. Sie 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 bietet eine Standardimplementierung von GCKUIImagePicker, mit der immer das erste Bild in der Liste der Bilder im GCKMediaMetadata-Objekt ausgewählt wird. Die Anwendung kann jedoch auch eine alternative Implementierung bieten, indem die imagePicker-Eigenschaft des Singleton-GCKCastContext-Elements festgelegt wird.
Das GCKUIImageCache-Protokoll definiert außerdem eine Möglichkeit zum Caching von Bildern, die vom Framework über 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 bieten. Dazu wird das Attribut imageCache des Singleton-Elements GCKCastContext festgelegt.
Nächste Schritte
Sie können Ihrer iOS-Sender-App jetzt keine Absender-Apps hinzufügen. Sie können jetzt eine Absender-App für eine andere Plattform (Android oder Web) oder einen Webempfänger erstellen.