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

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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของช่วงพักโฆษณาได้ที่ ภาพรวมช่วงพักโฆษณาของ Web Receiver

แม้ว่าจะระบุช่วงพักได้ทั้งใน Sender และ Receiver แต่เราขอแนะนำให้ระบุใน Web Receiver และ Android TV Receiver เพื่อให้การทำงานสอดคล้องกันในทุกแพลตฟอร์ม

ใน 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 วิธีในการสร้างแชแนลเพื่อส่งข้อความที่กำหนดเองไปยัง Web Receiver ดังนี้

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 Metadata รองรับ

แชแนลที่กำหนดเองแต่ละแชแนลจะกำหนดโดยเนมสเปซที่ไม่ซ้ำกันและต้องขึ้นต้นด้วย คำนำหน้า 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 การเล่นอัตโนมัติและการจัดคิว

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

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

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

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

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

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