เพิ่มฟีเจอร์ขั้นสูงในแอป iOS ของคุณ

ช่วงพักโฆษณา

SDK ผู้ส่งใน iOS รองรับช่วงพักโฆษณาและโฆษณาที่แสดงร่วมภายในสตรีมสื่อที่ระบุ

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทํางานของช่วงพักโฆษณาได้ในภาพรวมช่วงพักโฆษณาของโปรแกรมรับข้อมูลเว็บ

แม้ว่าจะระบุช่วงพักโฆษณาทั้งในผู้ส่งและผู้รับได้ แต่เราขอแนะนําให้คุณระบุช่วงพักในตัวรับสัญญาณของเว็บและตัวรับสัญญาณ Android TV เพื่อคงลักษณะการทํางานที่สอดคล้องกันในทุกแพลตฟอร์ม

ใน iOS ให้ระบุช่วงพักโฆษณาในคําสั่งโหลดโดยใช้ GCKAdBreakClipInfo และ GCKAdBreakInfo ดังนี้

สวิฟต์

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())

วัตถุประสงค์-C

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]];

อัตราการเล่นที่แปรผัน

แอปของคุณจะแสดงและเปลี่ยนอัตราการเล่นสําหรับรายการสื่อปัจจุบันได้ คุณสามารถตั้งค่าราคาโดยใช้ -[setPlaybackRate:] หรือ -[setPlaybackRate:customData:] ของ GCKRemoteMediaClient เข้าถึง GCKUIPlaybackRateController โดยใช้ playbackRateController ของ GCKUIMediaController และแสดงอัตราการเล่นปัจจุบันโดยใช้ playbackRate ของ GCKUIPlaybackRateController

รหัสตัวอย่าง

ไฟล์ 2 ไฟล์ต่อไปนี้ใช้ GCKUIPlaybackRateController ซึ่งควบคุมอัตราการเล่นโดยใช้ตัวควบคุมที่แบ่งกลุ่มที่มีปุ่ม "ปกติ" "ความเร็วครึ่งหนึ่ง" และ "ความเร็ว 2 เท่า"

สวิฟต์

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

วัตถุประสงค์-C

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

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

เพิ่มแชแนลที่กําหนดเอง

กรอบส่งมี 2 วิธีในการสร้างช่องเพื่อส่งข้อความที่กําหนดเองไปยังตัวรับสัญญาณเว็บ ดังนี้

1. GCKCastChannel มีไว้เพื่อเป็นกลุ่มย่อยเพื่อใช้ช่องที่ไม่ใช่พื้นฐานแล้วซึ่งมีสถานะเชื่อมโยงอยู่
2. GCKGenericChannel เป็นอีกทางเลือกหนึ่งในการทดแทนย่อย โดยส่ง SMS ที่ได้รับไปยังผู้รับมอบสิทธิ์ เพื่อให้คุณนําไปประมวลผลที่อื่นได้

ต่อไปนี้คือตัวอย่างของการติดตั้งใช้งาน GCKCastChannel

สวิฟต์

class HGCTextChannel: GCKCastChannel {
  override func didReceiveTextMessage(_ message: String) {
    print("received message: \(message)")
  }
}

วัตถุประสงค์-C

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

อาจมีการลงทะเบียนช่องได้ทุกเมื่อ หากเซสชันไม่อยู่ในสถานะที่เชื่อมต่อ ช่องจะเชื่อมต่อโดยอัตโนมัติเมื่อมีการเชื่อมต่อเซสชัน โดยที่เนมสเปซของช่องจะปรากฏในรายการของเนมสเปซที่รองรับของโปรแกรมรวบรวมข้อมูลเว็บ

แชแนลที่กําหนดเองแต่ละช่องกําหนดโดยเนมสเปซที่ไม่ซ้ํากันและต้องขึ้นต้นด้วย urn:x-cast: ตัวอย่างเช่น urn:x-cast:com.example.custom คุณอาจมีแชแนลที่กําหนดเองหลายแชแนล โดยแต่ละแชแนลจะมีเนมสเปซที่ไม่ซ้ํากัน แอป Web Receiver ยังสามารถส่งและรับข้อความโดยใช้เนมสเปซเดียวกันได้ด้วย

สวิฟต์

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

วัตถุประสงค์-C

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

หากต้องการระบุตรรกะที่จําเป็นต้องดําเนินการเมื่อเชื่อมต่อช่องใดช่องหนึ่งหรือไม่ได้เชื่อมต่อ ให้ลบล้างเมธอด -[didConnect] และ -[didDisconnect] หากใช้ GCKCastChannel หรือติดตั้งใช้งานเมธอดของ -[castChannelDidConnect:] และ -[castChannelDidDisconnect:] ของ GCKGenericChannelDelegate หากใช้ GCKGenericChannel

การรองรับการเล่นอัตโนมัติ

ดู API การเล่นอัตโนมัติและการจัดคิว

ลบล้างการเลือกและการแคชรูปภาพ

คอมโพเนนต์ต่างๆ ของเฟรมเวิร์ก (เช่น กล่องโต้ตอบแคสต์ ตัวควบคุมขนาดเล็ก ตัวควบคุมที่ขยาย และ GCKUIMediaController หากกําหนดค่าไว้) จะแสดงอาร์ตเวิร์กสําหรับสื่อที่แคสต์อยู่ โดยปกติแล้ว URL ที่ไปยังอาร์ตเวิร์กภาพจะรวมอยู่ใน GCKMediaMetadata ของสื่อ แต่แอปของผู้ส่งอาจมีแหล่งที่มาสํารองสําหรับ URL นั้น

โปรโตคอล GCKUIImagePicker กําหนดวิธีเลือกรูปภาพที่เหมาะสมสําหรับการใช้งานและขนาดที่ต้องการ โดยมีวิธีเดียวคือ -[getImageWithHints:fromMetadata:] ซึ่งใช้ออบเจ็กต์ GCKUIImageHints และออบเจ็กต์ GCKMediaMetadata เป็นพารามิเตอร์ และแสดงผลออบเจ็กต์ GCKImage เป็นผลลัพธ์ เฟรมเวิร์กจะมีการใช้ GCKUIImagePicker ตามค่าเริ่มต้น ซึ่งจะเลือกอิมเมจแรกในรายการอิมเมจในออบเจ็กต์ GCKMediaMetadata เสมอ แต่แอปสามารถติดตั้งใช้งานแบบอื่นได้โดยการตั้งค่าพร็อพเพอร์ตี้ imagePicker ของ GCKCastContext เดี่ยว

นอกจากนี้ โปรโตคอล GCKUIImageCache ยังกําหนดวิธีการแคชอิมเมจที่เฟรมดาวน์โหลดโดยใช้ HTTPS ด้วย เฟรมเวิร์กจะมีการใช้งานเริ่มต้นของ GCKUIImageCache ซึ่งเก็บไฟล์รูปภาพที่ดาวน์โหลดไว้ในไดเรกทอรีแคชของแอป แต่แอปสามารถติดตั้งใช้งานแบบอื่นได้โดยการตั้งค่าพร็อพเพอร์ตี้ imageCache ของ GCKCastContext singleton

ขั้นตอนถัดไป

ส่วนนี้สรุปฟีเจอร์ที่คุณสามารถเพิ่มไปยังแอป iOS Sender ของคุณ ขณะนี้คุณสามารถสร้างแอปผู้ส่งสําหรับแพลตฟอร์มอื่น (Android หรือ เว็บ) หรือสร้างตัวรับเว็บได้