Ihrer iOS-App erweiterte Funktionen hinzufügen

Werbeunterbrechungen

Das iOS-Sender-SDK unterstützt Werbeunterbrechungen und Companion-Anzeigen in einem bestimmten Medienstream.

Weitere Informationen zur Funktionsweise von Werbeunterbrechungen findest du unter Übersicht über Werbeunterbrechungen für Webreceiver.

Werbeunterbrechungen können sowohl beim Sender als auch beim Empfänger angegeben werden. Wir empfehlen jedoch, sie beim Webempfänger und beim Android TV-Empfänger anzugeben, um ein einheitliches Verhalten auf allen Plattformen zu gewährleisten.

Unter iOS kannst du Werbeunterbrechungen in einem Ladebefehl mit GCKAdBreakClipInfo und GCKAdBreakInfo angeben:

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. Sie können die Wiedergabegeschwindigkeit mit -[setPlaybackRate:] oder -[setPlaybackRate:customData:] auf der GCKRemoteMediaClient festlegen, über playbackRateController auf der GCKUIMediaController auf die GCKUIPlaybackRateController zugreifen und mit playbackRate auf der GCKUIPlaybackRateController die aktuelle Wiedergabegeschwindigkeit anzeigen.

Beispielcode

In den folgenden beiden Dateien wird GCKUIPlaybackRateController implementiert, mit dem die Wiedergabegeschwindigkeit über ein segmentiertes Steuerelement mit den Schaltflächen „Normal“, „Halbe Geschwindigkeit“ und „Doppelte Geschwindigkeit“ gesteuert wird:

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
  }
}

#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

#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, einen Kanal zum Senden benutzerdefinierter Nachrichten an einen Webempfänger zu erstellen:

1. GCKCastChannel sollte in eine Unterklasse unterteilt werden, um nicht triviale Kanäle mit einem zugehörigen Status zu implementieren.
2. GCKGenericChannel dient als Alternative zur Unterklasse. Es übergibt die empfangenen Nachrichten an einen Delegaten, 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)")
  }
}

#import <GoogleCast/GCKCastChannel.h>

@interface HGCTextChannel : GCKCastChannel

@end

#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, sofern der Namespace des Kanals in der Liste der unterstützten Namespaces in den Metadaten der Web Receiver App enthalten ist.

Jeder benutzerdefinierte Kanal wird durch einen eindeutigen Namespace definiert und muss mit dem Präfix urn:x-cast: beginnen, z. B. urn:x-cast:com.example.custom. Es ist möglich, mehrere benutzerdefinierte Channels mit jeweils einem eindeutigen Namespace zu haben. Die Web Receiver App kann auch Nachrichten senden und empfangen, indem sie denselben Namespace verwendet.

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 soll, wenn eine bestimmte Verbindung hergestellt oder getrennt wird, überschreiben Sie die Methoden -[didConnect] und -[didDisconnect], wenn Sie GCKCastChannel verwenden, oder implementieren Sie die Methoden -[castChannelDidConnect:] und -[castChannelDidDisconnect:] der GCKGenericChannelDelegate, wenn Sie GCKGenericChannel verwenden.

Unterstützung für die automatische Wiedergabe

Weitere Informationen finden Sie unter Autoplay- und Wiedergabelisten-APIs.

Bildauswahl und Caching überschreiben

In verschiedenen Komponenten des Frameworks (nämlich im Streaming-Dialogfeld, im Mini-Controller, im erweiterten Controller und in der GCKUIMediaController, sofern konfiguriert) wird Artwork für die derzeit gestreamten Medien angezeigt. Die URLs zu den Bild-Artworks sind in der Regel im GCKMediaMetadata für die Medien enthalten. Die Absender-App kann jedoch eine alternative Quelle für die URLs haben.

Das Protokoll GCKUIImagePicker definiert eine Möglichkeit, ein geeignetes Bild für eine bestimmte Verwendung und gewünschte Größe auszuwählen. Es hat eine einzige Methode, -[getImageWithHints:fromMetadata:], die ein GCKUIImageHints-Objekt und ein GCKMediaMetadata-Objekt als Parameter annimmt und ein GCKImage-Objekt als Ergebnis zurückgibt. Das Framework bietet eine Standardimplementierung von GCKUIImagePicker, bei der immer das erste Bild in der Liste der Bilder im GCKMediaMetadata-Objekt ausgewählt wird. Die App kann jedoch eine alternative Implementierung bereitstellen, indem die Property imagePicker des Singletons GCKCastContext festgelegt wird.

Das Protokoll GCKUIImageCache definiert auch 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 Cacheverzeichnis der App speichert. Die App kann jedoch eine alternative Implementierung bereitstellen, indem die Eigenschaft imageCache des Singletons GCKCastContext festgelegt wird.

Nächste Schritte

Das sind alle Funktionen, die Sie Ihrer iOS-Sender-App hinzufügen können. Sie können jetzt eine Sender-App für eine andere Plattform (Android oder Web) oder einen Webempfänger erstellen.