使用 iOS 版本原生 SDK 的程式碼片段

目錄

AirPlay的自定義控件

如果您使用Brightcove PlayerUI 控件 , 你都準備好了。AirPlay功能是開箱即用的，允許用戶使用Apple TV將視頻流傳輸到高清顯示器。

如果使用自定義控件，則可以按照以下步驟操作：

1. 了解有關 AirPlay 的信息Apple 的 AirPlay 開發者文檔 .

2. 使用播放控制器的allowsExternalPlayback 設置 AVPlayer 的屬性allowsExternalPlayback 財產：

   _playbackController.allowsExternalPlayback = YES;

   Objective-C

   playbackController.allowsExternalPlayback = true

   Swift

3. 設置AirPlay路由器控件並處理其選擇。有關詳細信息，請參閱Apple 的 AirPlay 概述文檔。

參考

有關詳細信息，請參閱 BCOVPlaybackController 文檔。

自定義隱藏式字幕按鈕

這BCOVPlayerUI 示例代碼向您展示瞭如何在使用適用於 iOS 的 Native SDK 時自定義 Brightcove 播放器。有關詳細信息，請參閱自定義 PlayerUI 控件本機 SDK 參考文檔的部分。

要使用PlayerUI自定義隱藏式字幕按鈕，請按照以下步驟操作：

1. 開始於基本視頻播放應用程序 .

2. 替換為策略密鑰，帳戶ID和視頻ID的值。從您的帳戶中選擇一個具有文本軌道的視頻。

3. 使用標準的VOD佈局設置播放器視圖：

   // Set up our player view. Create with a standard VOD layout.
   BCOVPUIPlayerView *playerView = [[BCOVPUIPlayerView alloc]
   initWithPlaybackController:self.playbackController options:nil controlsView:
   [BCOVPUIBasicControlView basicControlViewWithVODLayout] ];

   Objective-C

   // Set up our player view. Create with a standard VOD layout.
   guard let playerView = BCOVPUIPlayerView(playbackController:
   self.playbackController, options: options, controlsView:
   BCOVPUIBasicControlView.withVODLayout()) else {
     return
   }

   Swift

4. 這closedCaptionButton被聲明為BCOVPUIButton , 這是一個子類UIButton並添加了三種額外的自定義方法。每當您自定義BCOVPlayerUI控件時，都應在可用的地方使用Native Player API。您的自定義代碼應類似於以下內容：

   // Customize the CC button.
   BCOVPUIButton *ccButton = playerView.controlsView.closedCaptionButton;
   ccButton.titleLabel.font = [UIFont systemFontOfSize:14.];
   ccButton.primaryTitle = @"CC";
   [ccButton showPrimaryTitle:YES];

   Objective-C

   if let ccButton = playerView.controlsView.closedCaptionButton {
     ccButton.titleLabel?.font = UIFont.systemFont(ofSize: 14)
     ccButton.primaryTitle = "CC"
     ccButton.showPrimaryTitle(true)}
   }

   Swift

在外部屏幕上顯示FairPlay內容

使用AV適配器和HDMI電纜將外部顯示器連接到iOS設備時，默認行為是鏡像iOS屏幕。例外情況是當您使用受 FairPlay 保護的視頻時，Apple 會阻止其鏡像 ( WWDC 2015，第 502 節 ).

要顯示受FairPlay保護的視頻，請設置通過Brightcove播放控制器公開的AVPlayer屬性，以允許FairPlay視頻在外部顯示器上播放。視頻以全屏模式播放。這是設置這些屬性的示例：

playbackController.allowsExternalPlayback = YES;
playbackController.usesExternalPlaybackWhileExternalScreenIsActive = YES;

playbackController.allowsExternalPlayback = true
playbackController.usesExternalPlaybackWhileExternalScreenIsActive = true

參考

有關詳細信息，請參閱 BCOVPlaybackController 文檔。

Google Analytics

如果您使用 Brightcove 播放器和目錄類別，系統會自動收集影片分析，並顯示在您的視訊雲端分析模組中。對於其他指標，您可以將谷歌分析添加到您的應用程序。

若要將 Google Analytics 與您的應用程式整合，請依照下列步驟操

1. 查看 Google 的文檔以將分析添加到您的 iOS 應用程序 .

2. 您可以使用以下一種方法使用Google Analytics（分析）來通過Google的Firebase SDK跟踪視頻播放：

   // This snippet shows one way to track video playback
   // using the Firebase SDK from Google Analytics with
   // the lifecycle event playback controller delegate method.
   - (void)playbackController:(id<BCOVPlaybackController>)controller playbackSession:(id<BCOVPlaybackSession>)session didReceiveLifecycleEvent:(BCOVPlaybackSessionLifecycleEvent *)lifecycleEvent
   {
     // Common parameters
     NSString *video_name = session.video.properties[kBCOVVideoPropertyKeyName];
     NSString *video_ID = session.video.properties[kBCOVVideoPropertyKeyId];
   
     // Session is ready to play
     if ([kBCOVPlaybackSessionLifecycleEventReady isEqualToString:lifecycleEvent.eventType])
     {
       [FIRAnalytics logEventWithName:@"bcov_video_ready"
         parameters:@{
             @"bcov_video_name": video_name,
             @"bcov_video_id": video_ID
         }];
     }
   
     // Session encountered an error
     if ([kBCOVPlaybackSessionLifecycleEventError isEqualToString:lifecycleEvent.eventType])
     {
       NSError *error = lifecycleEvent.properties[kBCOVPlaybackSessionEventKeyError];
       int error_code = error.code;
       [FIRAnalytics logEventWithName:@"bcov_video_playback_error"
         parameters:@{
             @"bcov_video_name": video_name,
             @"bcov_video_id": video_ID,
             @"bcov_video_error_code": @(error_code)
         }];
     }
   
     // Session has completed
     if ([kBCOVPlaybackSessionLifecycleEventTerminate isEqualToString:lifecycleEvent.eventType])
     {
       [FIRAnalytics logEventWithName:@"bcov_video_terminate"
         parameters:@{
             @"bcov_video_name": video_name,
             @"bcov_video_id": video_ID
          }];
     }
   }

   Objective-C

   // This snippet shows one way to track video playback
   // using the Firebase SDK from Google Analytics with
   // the lifecycle event playback controller delegate method.
   func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {
   
       // Common parameters
       let video_name = session.video.properties[kBCOVVideoPropertyKeyName]
       let video_id = session.video.properties[kBCOVVideoPropertyKeyId]
   
       // Session is ready to play
       if (lifecycleEvent.eventType == kBCOVPlaybackSessionLifecycleEventReady) {
   
           if let video_name = video_name as? String, let video_id = video_id as? String {
               Analytics.logEvent("bcov_video_ready", parameters: [
                   "bcov_video_name" : video_name,
                   "bcov_video_id" : video_id
               ])
           }
   
       }
   
       // Session encountered an error
       if (lifecycleEvent.eventType == kBCOVPlaybackSessionLifecycleEventError) {
   
           if let error = lifecycleEvent.properties[kBCOVPlaybackSessionEventKeyError] as? NSError {
               let error_code = error.code
   
               if let video_name = video_name as? String, let video_id = video_id as? String {
                   Analytics.logEvent("bcov_video_playback_error", parameters: [
                       "bcov_video_name" : video_name,
                       "bcov_video_id" : video_id,
                       "bcov_video_error_code" : error_code
                   ])
               }
           }
   
       }
   
       // Session has completed
       if (lifecycleEvent.eventType == kBCOVPlaybackSessionLifecycleEventTerminate) {
   
           if let video_name = video_name as? String, let video_id = video_id as? String {
               Analytics.logEvent("bcov_video_terminate", parameters: [
                   "bcov_video_name" : video_name,
                   "bcov_video_id" : video_id
               ])
           }
   
       }
   
   }

   Swift

限制比特率

您無法控制 HLS 清單中的哪個源（再現）被AVPlayer , 但您可以在播放時設置比特率上限。這樣可以防止播放器使用比特率超過指定比特率的源（繼承）。

設置preferredPeakBitRate 到給定的網絡帶寬消耗的所需限制（以每秒位數為單位）AVPlayerItem .

使用以下聲明之一：

[self.playbackController setPreferredPeakBitRate:1000];

playbackController.setPreferredPeakBitRate(1000)

循環播放視頻

在某些情況下，您可能希望視頻自動重播。為此，您可以獲取“視頻結尾”生命週期事件，尋找開始並再次播放。

此代碼假定您已使用以下方法將playbackController的委託設置為該對象：

- (void)playbackController:(id<BCOVPlaybackController>)controller playbackSession:(id<BCOVPlaybackSession>)session didReceiveLifecycleEvent:(BCOVPlaybackSessionLifecycleEvent *)lifecycleEvent
{
  if ([kBCOVPlaybackSessionLifecycleEventEnd isEqualToString:lifecycleEvent.eventType])
  {
    [controller seekToTime:kCMTimeZero completionHandler:^(BOOL finished) {
      if (finished)
      {
        [controller play];
      }
    }];
  }
}

func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {

    if (lifecycleEvent.eventType == kBCOVPlaybackSessionLifecycleEventEnd) {
        controller.seek(to: CMTime.zero) { (finished: Bool) in
            if (finished) {
                controller.play()
            }
        }
    }

}

管理播放列表中的視頻

管理視頻播放列表的一種方法是將視頻對象存儲在表中。當用戶從表格中選擇視頻時，表格行將包含視頻對象。

以下是其工作原理的概述：

1. 從您的帳戶中檢索播放列表。

   - (void)retrievePlaylist
   {
     [self.refreshControl beginRefreshing];
   
     // Retrieve a playlist through the BCOVPlaybackService
     BCOVPlaybackServiceRequestFactory *playbackServiceRequestFactory = [[BCOVPlaybackServiceRequestFactory alloc]
     initWithAccountId:kDynamicDeliveryAccountID
     policyKey:kDynamicDeliveryPolicyKey];
     BCOVPlaybackService *playbackService = [[BCOVPlaybackService alloc] initWithRequestFactory:playbackServiceRequestFactory];
   
     [playbackService findPlaylistWithReferenceID:kDynamicDeliveryPlaylistRefID parameters:nil
     completion:^(BCOVPlaylist *playlist, NSDictionary *jsonResponse, NSError *error)
     {
       [self.refreshControl endRefreshing];
   
       NSLog(@"JSON Response:\n%@", jsonResponse);
   
       if (playlist)
       {
         self.currentVideos = playlist.videos.mutableCopy;
         self.currentPlaylistTitle = playlist.properties[@"name"];
         self.currentPlaylistDescription = playlist.properties[@"description"];
   
         NSLog(@"Retrieved playlist containing %d videos", (int)self.currentVideos.count);
   
         [self usePlaylist:self.currentVideos];
       }
       else
       {
         NSLog(@"No playlist for ID %@ was found.", kDynamicDeliveryPlaylistRefID);
       }
   
     }];
   }

   Objective-C

   func retrievePlaylist() {
       refreshControl.beginRefreshing()
   
       let playbackServiceRequestFactory = BCOVPlaybackServiceRequestFactory(accountId: kDynamicDeliveryAccountID, policyKey: kDynamicDeliveryPolicyKey)
       let playbackService = BCOVPlaybackService(requestFactory: playbackServiceRequestFactory)
   
       playbackService?.findPlaylist(withPlaylistID: kDynamicDeliveryPlaylistRefID, parameters: nil, completion: { [weak self] (playlist: BCOVPlaylist?, jsonResponse: [AnyHashable:Any]?, error: Error?) in
   
           guard let strongSelf = self else {
               return
           }
   
           strongSelf.refreshControl.endRefreshing()
   
           if let playlist = playlist {
               strongSelf.currentVideos = playlist.videos
               strongSelf.currentPlaylistTitle = playlist.properties["name"] as? String ?? ""
               strongSelf.currentPlaylistDescription = playlist.properties["description"] as? String ?? ""
   
               print("Retrieved playlist containing \(playlist.videos.count) videos")
   
               strongSelf.usePlaylist(playlist)
           } else {
               print("No playlist for ID \(kDynamicDeliveryPlaylistRefID) was found.");
           }
   
       })
   }

   Swift

2. 重新初始化用於在當前播放列表中存儲與視頻相關的信息的容器。

3. 選擇表視圖時，該行的索引用於創建一個新的videoDictionary .接下來，向字典詢問視頻。如果視頻不為空，則將視頻加載到playbackController .

   // Play the video in this row when selected
   - (IBAction)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(nonnull NSIndexPath *)indexPath
   {
     NSDictionary *videoDictionary = self.videosTableViewData[ (int)indexPath.row ];
     BCOVVideo *video = videoDictionary[@"video"];
   
     if (video != nil)
     {
       [self.playbackController setVideos:@[ video ]];
     }
   }

   Objective-C

   func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
   
       guard let videosTableViewData = videosTableViewData,
       let videoDictionary = videosTableViewData[indexPath.row] as?
       [AnyHashable:Any], let video = videoDictionary["video"] as? BCOVVideo else {
           return
       }
   
       playbackController.setVideos([video] as NSFastEnumeration)
   
   }

   Swift

要使用播放列表，您可以將播放列表存儲在另一個對象（例如表格）中。基於用戶交互，您可以導航對象的索引並選擇適當的視頻。

媒體進度值

在媒體播放期間，報告給Player SDK進度委託方法的值可能包括負無窮大的初始值和正無窮大的最終值。這些值在處理前貼片廣告和後貼片廣告時使用。

如果這些值對您不重要或乾擾您自己的進度跟踪，則可以使用以下條件語句輕鬆忽略它們：

- (void)playbackController:(id<BCOVPlaybackController>)controller playbackSession:(id<BCOVPlaybackSession>)session didProgressTo:(NSTimeInterval)progress
{
  if (progress < 0.0 || progress >= INFINITY)
  {
    return;
  }

  // Your code here
}

func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didProgressTo progress: TimeInterval) {

    if (progress < 0.0 || progress >= Double.infinity) {
        return;
    }

    // Your code here
}

參考

有關詳細信息，請參閱 BCOVPlaybackController 文檔。

以編程方式修改字幕

您可以在播放過程中隨時設置字幕，在Ready已收到事件。為此，您可以使用 BCOVPlaybackControllerDelegate 。

以下是將字幕語言設置為西班牙語的示例：

- (void)playbackController:(id<BCOVPlaybackController>)controller playbackSession:(id<BCOVPlaybackSession>)session didReceiveLifecycleEvent:(BCOVPlaybackSessionLifecycleEvent *)lifecycleEvent
  {
      if ([kBCOVPlaybackSessionLifecycleEventReady isEqualToString:lifecycleEvent.eventType])
      {
          AVMediaSelectionGroup *legibleMediaSelectionGroup = session.legibleMediaSelectionGroup;
          NSArray<AVMediaSelectionOption *> *options = [AVMediaSelectionGroup mediaSelectionOptionsFromArray:legibleMediaSelectionGroup.options withLocale:[NSLocale localeWithLocaleIdentifier:@"es"]];
          AVMediaSelectionOption *option = options.firstObject;
          session.selectedLegibleMediaOption = option;
      }
  }

func playbackController(_ controller: BCOVPlaybackController?, playbackSession session: BCOVPlaybackSession?, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent?) {
    if kBCOVPlaybackSessionLifecycleEventReady == lifecycleEvent?.eventType {
        if let legibleMediaSelectionGroup = session?.legibleMediaSelectionGroup.options {
            let locale = NSLocale(localeIdentifier: "es") as Locale
            let mediaSelectionOptions = AVMediaSelectionGroup.mediaSelectionOptions(from: legibleMediaSelectionGroup, with: locale)
            let mediaSelectionOption = mediaSelectionOptions.first
            session?.selectedLegibleMediaOption = mediaSelectionOption
        }
    }
}

使用播放 API 進行分頁

從播放 API 擷取您的視訊雲端內容時，您可以為播放清單實作分頁。

若要逐頁瀏覽播放清單中的一組影片，請使用下列要求 URL 參數：

• limit -定義要從Playback API返回的視頻數
• offset -設置要從Playback API播放列表中跳過的視頻數

此範例會傳回以播放清單中第 10 個視訊開頭的 6 個視訊：

NSDictionary *params = @{
  @"limit": @6,
  @"offset": @9
};

[playbackService findPlaylistWithReferenceID:playlistRefID parameters:params completion:^(BCOVPlaylist *playlist, NSDictionary *jsonResponse, NSError *error)
{
    // Your code here
}];

let params = [
    "limit": 6,
    "offset": 9
]

playbackService?.findPlaylist(withPlaylistID: playlistRefID, parameters: params, completion: { (playlist: BCOVPlaylist?, jsonResponse: [AnyHashable:Any]?, error: Error?) in
    // Your code here
})

以編程方式添加提示點

Video Cloud 客戶可以使用 Video Cloud Studio 向視頻添加提示點，如向視頻添加提示點文檔。

您還可以通過編程將提示點添加到視頻中。以下代碼將季度間隔提示點添加到從Playback API返回的視頻中：

// programmatically add cue points to a video
- (void)requestContentFromPlaybackService
{
    [self.service findVideoWithVideoID:kViewControllerVideoID parameters:nil completion:^(BCOVVideo *video, NSDictionary *jsonResponse, NSError *error) {
        if (video)
        {
            // Get the video duration from the properties dictionary
            NSNumber *durationNumber = video.properties[@"duration"]; // milliseconds
            float duration = durationNumber.floatValue / 1000.0; // convert to seconds
            video = [video update:^(id<BCOVMutableVideo> mutableVideo)
            {
                // Add quarterly interval cue points of your own type
                BCOVCuePoint *cp1 = [[BCOVCuePoint alloc] initWithType:@"your cue point type" position:CMTimeMake(duration * 250, 1000)];
                BCOVCuePoint *cp2 = [[BCOVCuePoint alloc] initWithType:@"your cue point type" position:CMTimeMake(duration * 500, 1000)];
                BCOVCuePoint *cp3 = [[BCOVCuePoint alloc] initWithType:@"your cue point type" position:CMTimeMake(duration * 750, 1000)];
                BCOVCuePoint *cp4 = [[BCOVCuePoint alloc] initWithType:@"your cue point type" position:CMTimeMake(duration * 1000, 1000)];
                // Create new cue point collection using existing cue points and new cue points
                NSMutableArray *newCuePoints = [[NSMutableArray alloc] initWithArray:mutableVideo.cuePoints.array];
                [newCuePoints addObject:cp1];
                [newCuePoints addObject:cp2];
                [newCuePoints addObject:cp3];
                [newCuePoints addObject:cp4];
                mutableVideo.cuePoints = [[BCOVCuePointCollection alloc] initWithArray:newCuePoints];
            }];

            [self.playbackController setVideos:@[ video ]];
        }
        else
        {
            NSLog(@"ViewController Debug - Error retrieving video: `%@`", error);
        }
    }];
}

// programmatically add cue points to a video
func requestContentFromPlaybackService() {
    playbackService?.findVideo(withVideoID: kViewControllerVideoID, parameters: nil)
    { [weak self] (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in

        if let error = error {
            print("ViewController Debug - Error retrieving video: `\(error.localizedDescription)`")
        }

        if let video = video {

            // Get the video duration from the properties dictionary
            guard let durationNumber = video.properties["duration"] as? NSNumber else {
                return
            }

            let duration = durationNumber.floatValue / 1000.0; // convert to seconds

            let updatedVideo = video.update({ (mutableVideo: BCOVMutableVideo?) in

                guard let mutableVideo = mutableVideo else {
                    return
                }

                // Add quarterly interval cue points of your own type
                let cp1Position = CMTimeMake(value: Int64(duration * 250), timescale: 1000)
                let cp1 = BCOVCuePoint(type: "your cue point type", position: cp1Position)!
                let cp2Position = CMTimeMake(value: Int64(duration * 500), timescale: 1000)
                let cp2 = BCOVCuePoint(type: "your cue point type", position: cp2Position)!
                let cp3Position = CMTimeMake(value: Int64(duration * 750), timescale: 1000)
                let cp3 = BCOVCuePoint(type: "your cue point type", position: cp3Position)!
                let cp4Position = CMTimeMake(value: Int64(duration * 1000), timescale: 1000)
                let cp4 = BCOVCuePoint(type: "your cue point type", position: cp4Position)!

                // Create new cue point collection using existing cue points and new cue points
                var newCuePoints = [BCOVCuePoint]()
                newCuePoints.append(cp1)
                newCuePoints.append(cp2)
                newCuePoints.append(cp3)
                newCuePoints.append(cp4)

                mutableVideo.cuePoints = BCOVCuePointCollection(array: newCuePoints)
            })

            self?.playbackController.setVideos([updatedVideo] as NSFastEnumeration)
        }

    }
}

請注意，值your cue point type 可以是您想要的任何字符串值，只要您不使用任何iOS插件 .有關詳細信息，請參閱BCOVCuePoint 協議參考文檔。

如果您在 IMA 插件中使用提示點，請在VAST 和 VMAP/服務器端廣告規則 IMA 插件的 Native SDK for iOS 註釋部分。這IMA 示例應用顯示 IMA 廣告提示點所需的值。

下面的代碼偵聽您的提示點並顯示一條消息：

// listen for cue points and display them
-(void)playbackController:(id<BCOVPlaybackController>)controller playbackSession:(id<BCOVPlaybackSession>)session didPassCuePoints:(NSDictionary *)cuePointInfo
{
    BCOVCuePointCollection *cpc = cuePointInfo[@"kBCOVPlaybackSessionEventKeyCuePoints"];
    for (BCOVCuePoint *cp in cpc.array)
    {
        if ([cp.type isEqualToString:@"your cue point type"])
        {
            NSLog(@"Found your cue point at %f", CMTimeGetSeconds(cp.position));
        }
    }
}

// listen for cue points and display them
func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didPassCuePoints cuePointInfo: [AnyHashable : Any]!) {
    if let cpc = cuePointInfo[kBCOVPlaybackSessionEventKeyCuePoints] as? BCOVCuePointCollection {
        for cp in cpc.array() {
            if let cp = cp as? BCOVCuePoint {
                if (cp.type == "your cue point type") {
                    print("Found your cue point at \(CMTimeGetSeconds(cp.position))")
                }
            }
        }
    }
}

參考

如需詳細資訊，請參閱下列內容：

• BCOV視頻 文檔
• BCOVCuePoint 文檔

卸下播放器

在某些情況下，您想刪除播放器和視圖。

取消分配擁有 a 所有權的視圖控制器BCOVPlaybackController也將取消分配播放控制器。為此，從其父視圖中刪除播放器視圖並將其播放控制器指針設置為nil .

這是一個代碼示例：

[self.playerView removeFromSuperview];
self.playerView = nil;
self.playbackController = nil;

playerView?.removeFromSuperview()
playerView = nil
playbackController = nil

設置音頻行為

音訊工作階段會處理應用程式層級的音訊行為。您可以從數個音訊工作階段類別和設定中選擇，以自訂應用程式的音訊行為。

為您的應用程式選擇最佳的音訊工作階段類別。有關詳細信息，請查看 Apple 的文檔：

• AVAudioSession 類
• AVAudioSession類別

基礎樣本

對於我們的基本示例，我們使用AVAudioSessionCategoryPlayback .即使螢幕鎖定且「鈴聲/靜音」開關設定為靜音，也會播放音訊。為了簡單起見，我們將代碼放在 App Delegate 中。

NSError *categoryError = nil;
  BOOL success = [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:&categoryError];
  if (!success)
  {
      // Handle error
  }

var categoryError :NSError?
  var success: Bool
  do {
      try AVAudioSession.sharedInstance().setCategory(.playback)
      success = true
  } catch let error as NSError {
      categoryError = error
      success = false
  }
  if !success {
      // Handle error
  }

與其他音頻混合

當您的應用程序中的音頻被靜音時，您可能希望允許聽到來自其他應用程序的音頻。為此，您可以配置AVAudioSession在有權訪問您當前的視圖控制器中AVPlayer .

有關詳細信息，請參閱 mixWithOthers 類別選項。

- (void)setUpAudioSession
  {
      NSError *categoryError = nil;
      BOOL success;

      // If the player is muted, then allow mixing.
      // Ensure other apps can have their background audio active when this app is in foreground
      if (self.currentPlayer.isMuted)
      {
          success = [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback withOptions:AVAudioSessionCategoryOptionMixWithOthers error:&categoryError];
      }
      else
      {
          success = [[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback withOptions:0 error:&categoryError];
      }

      if (!success)
      {
          NSLog(@"AppDelegate Debug - Error setting AVAudioSession category.  Because of this, there may be no sound. `%@`", categoryError);
      }
  }

func setUpAudioSession() {
  var categoryError :NSError?
  var success: Bool
  do {
      if let currentPlayer = currentPlayer {
          // If the player is muted, then allow mixing.
          // Ensure other apps can have their background audio active when this app is in foreground
          if currentPlayer.isMuted {
              try AVAudioSession.sharedInstance().setCategory(.playback, options: .mixWithOthers)
          } else {
              try AVAudioSession.sharedInstance().setCategory(.playback, options: AVAudioSession.CategoryOptions(rawValue: 0))
          }
      } else {
          try AVAudioSession.sharedInstance().setCategory(.playback, options: AVAudioSession.CategoryOptions(rawValue: 0))
      }

      success = true
  } catch let error as NSError {
      categoryError = error
      success = false
  }
  if !success {
      print("AppDelegate Debug - Error setting AVAudioSession category.  Because of this, there may be no sound. \(categoryError!)")
  }
}

設定播放速率

要控製播放速率，您可以設置rate 上的財產AVPlayer 在會話中公開的類。

默認情況下，只能以固定間隔（0.50、0.67、1.0、1.25、1.50和2.0）設置播放速率。通過設置audioTimePitch算法，您可以使用更精細的速率值（如 1.7）。有關詳細信息，請參閱此計算器討論 .

avPlayerItem.audioTimePitchAlgorithm = AVAudioTimePitchAlgorithmVarispeed;

為一個BCOVPlaybackSession ，您的代碼將類似於：

- (void)playbackController:(id<BCOVPlaybackController>)controller
  playbackSession:(id<BCOVPlaybackSession>)session didReceiveLifecycleEvent:(BCOVPlaybackSessionLifecycleEvent *)lifecycleEvent
{
    if ( [lifecycleEvent.eventType isEqualToString:kBCOVPlaybackSessionLifecycleEventReady] )
    {
        NSLog(@"%@ at time %f", kBCOVPlaybackSessionLifecycleEventReady, CMTimeGetSeconds([session.player currentTime]));
        AVPlayerItem *avPlayerItem = [session.player currentItem];
        avPlayerItem.audioTimePitchAlgorithm = AVAudioTimePitchAlgorithmVarispeed;
        session.player.rate = 1.7;
    }
}

func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {

    if (lifecycleEvent.eventType == kBCOVPlaybackSessionLifecycleEventReady) {
        let seconds = CMTimeGetSeconds(session.player.currentTime())
        print("kBCOVPlaybackSessionLifecycleEventReady at time \(seconds)")
        let avPlayerItem = session.player.currentItem
        avPlayerItem?.audioTimePitchAlgorithm = AVAudioTimePitchAlgorithm.varispeed
        session.player.rate = 1.7
    }

}

為 360° 影片設定 VR 護目鏡模式

播放 360° 影片時，使用者可以選擇控制列上的 360 視訊按鈕，切換至 VR 護目鏡模式。在開始播放之前，您可能還需要以編程方式執行此操作。您可以通過更新BCOVPlaybackController 協議的viewProjection 屬性如下：

- (void)playbackController:(id<BCOVPlaybackController>)controller didAdvanceToPlaybackSession:(id<BCOVPlaybackSession>)session
{
    BCOVVideo360ViewProjection *viewProjection = [self.playbackController.viewProjection copy];
    [viewProjection setProjectionStyle:BCOVVideo360ProjectionStyleVRGoggles];
    [self.playbackController setViewProjection:viewProjection];
}

func playbackController(_ controller: BCOVPlaybackController!, didAdvanceTo session: BCOVPlaybackSession!) {
    if let viewProjection: BCOVVideo360ViewProjection = controller.viewProjection.copy() as? BCOVVideo360ViewProjection {
        viewProjection.projectionStyle = BCOVVideo360ProjectionStyle.vrGoggles
        playbackController.viewProjection = viewProjection
    }
}

更改背景顏色

在縱向模式下播放視頻時，您可能會在播放器的頂部和下方看到黑色邊框。播放器視圖是屏幕的大小，但是視頻僅佔播放器視圖中心的一小部分。視頻周圍的可見部分是播放器層的背景。

這個是正常的AVPlayer 行為。它會縮小視頻以使其適合播放器層，其餘部分則是播放器層背景。

您可以使用以下代碼更改播放器圖層背景：

- (void)playbackController:(id<BCOVPlaybackController>)controller didAdvanceToPlaybackSession:(id<BCOVPlaybackSession>)session
{
    session.playerLayer.backgroundColor = UIColor.whiteColor.CGColor;
}

func playbackController(_ controller: BCOVPlaybackController!, didAdvanceTo session: BCOVPlaybackSession!) {
    session.playerLayer.backgroundColor = UIColor.white.cgColor
}

將背景色設置為白色應如下所示：