メインコンテンツまでスキップ

音声再生

このガイドでは、 BlendVision iOS プレーヤー SDK により、音声専用アセットプレーヤーの設置方法を説明します。音声専用アセットプレーヤーについては、サンプルプロジェクトを確認可能です。
基本のプレーヤー SDK 統合については、はじめにを参考してください。

ビデオ再生との顕著な違い​

バックグラウンド画像​

音声ストリームを再生する時に、デフォルトの背景色は黒です。次のスニペットのように、UniSourceConfig.posterSource 方法にて背景色をカスタマイズ可能です:

<style>
 #player-container video {
   background: no-repeat center / contain url(image-url)
 }
</style>

<body>
  <div id="player-container">
  </div>
</body>

解像度設定​

解像度設定は複数のビットレート変数があるビデオストリームを適用しますが、音声専用ストリームは 利用できません。

カスタム UI​

iOS または tvOS でこのオブジェクトを利用する一般的な方法は、次の例に示すように、UIView のバッキングレイヤとして使用することです:

/// A view that displays the visual contents of a player object.
class CustomView: UIView {

    // Override the property to make AVPlayerLayer the view's backing layer.
    override static var layerClass: AnyClass { AVPlayerLayer.self }

    // The associated player object.
    var player: AVPlayer? {
        get { playerLayer.player }
        set { playerLayer.player = newValue }
    }

    private var playerLayer: AVPlayerLayer { layer as! AVPlayerLayer }
}
重要
  • プレーヤーレイヤーの継承されたコンテンツプロパティ値は不透明であるため、変更できません。

設置​

// Define needed resources
guard let streamUrl = URL(string: "YOUR_HLS_URL")else {
    return
}

// Create player configuration
let playerConfig = UniPlayerConfig()
playerConfig.key = "YOUR_PLAYER_LICENSE_KEY"

// Create player based on player config
player = UniPlayerFactory.create(player: playerConfig)

// Create custom view and pass the player instance to it
let playerView = CustomView(player: player, frame: .zero)

// Listen to player events
player.add(listener: self)

playerView.autoresizingMask = [.flexibleHeight, .flexibleWidth]
playerView.frame = view.bounds

view.addSubview(playerView)
view.bringSubviewToFront(playerView)

// Create source config
let sourceConfig = UniSourceConfig(url: YOUR_HLS_URL, type: .hls)

// Set poster url to posterSource of UniSourceConfig
sourceConfig.posterSource = URL(string: YOUR_IMAGE_URL)
player.load(sourceConfig: sourceConfig)
制限事項
  • クロムキャストで音声再生ができない可能性があります。

アプリに必要なバックグラウンドモードを指定する​

アプリが1つ以上のバックグラウンド実行モードを利用できるには、次の手順を実行して必要なモードを宣言する必要があります:

  1. Xcode のプロジェクトナビゲーターでプロジェクトを選択します。
  2. ターゲットリストでアプリのターゲットを選択します。
  3. プロジェクトエディターで「Signing & Capabilities」タブをクリックします。
  4. 「バックグラウンドモード」の機能を探します。
  5. 対応するチェックボックスを利用して、1つ以上のバックグラウンド実行モードを選択します。
  6. watchOS アプリの場合は、ポップアップメニューから適切なセッションタイプを選択します。