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

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

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

โปรดดู ภาพรวมช่วงพักโฆษณาในเว็บรีซีฟเวอร์สำหรับข้อมูลเพิ่มเติม เกี่ยวกับวิธีการทำงานของช่วงพักโฆษณา

แม้ว่าจะสามารถระบุช่วงพักได้ทั้งกับผู้ส่งและผู้รับ แต่เราขอแนะนำให้เป็น ที่ระบุไว้ในเว็บรีซีฟเวอร์และ ตัวรับสัญญาณ Android TV เพื่อให้คงความสม่ำเสมอ พฤติกรรมบนแพลตฟอร์มต่างๆ

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

Swift
วันที่
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())
Objective-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 เท่า" ปุ่ม:

Swift
วันที่
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
  }
}
Objective-C

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

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

เฟรมเวิร์ก Cast มี 2 วิธีในการสร้างช่องสำหรับส่งข้อความที่กำหนดเอง ไปยังเว็บรีซีฟเวอร์:

  1. GCKCastChannel ต้องมีการแยกประเภทย่อยเพื่อใช้แชแนลที่ไม่สำคัญ สถานะที่เกี่ยวข้อง
  2. GCKGenericChannel เป็นทางเลือกในการจัดประเภทย่อย คะแนนผ่านไป ข้อความให้กับผู้รับมอบสิทธิ์ เพื่อให้นำไปประมวลผลที่อื่นได้

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

Swift
วันที่
class HGCTextChannel: GCKCastChannel {
  override func didReceiveTextMessage(_ message: String) {
    print("received message: \(message)")
  }
}
Objective-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

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

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

Swift
วันที่
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)")
}
Objective-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 Singleton

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

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

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