ReplayKitによるローリングクリップ

ゲームやAppで、誰かの素晴らしい瞬間を見逃すことはもうありません。過去のビデオやオーディオサンプルのローリングバッファを提供するReplayKitの最新のアップデート（クリップスクリーンレコーディング）について紹介します。忘れられない瞬間が起きたとき、それを記録して人々のために保存し、最も関連性の高いときにそれらのクリップを表示する方法をご確認ください。最後に、ReplayKitをiOSやmacOSのAppに統合する方法を紹介します。

リソース

関連ビデオ

WWDC21

WWDC20

ReplayKitを使用したMac上でのAppの取り込みとストリーミング

ダウンロード

ようこそ「ReplayKitによるローリングクリップ」へ ReplayKitチームのソフトウェアエンジニアの Ernestです　今日はApp内でのハイライトを録画する方法を紹介します　まずReplayKitの概要を解説します　

ReplayKitはApp画面と音声を録画する方法です　マニュアル動画を作るときやゲームプレイを公開したいとき App内で画面収録して動画を作成し保存して友人と共有できます　作った動画をより細かく加工したいときフィルタやオーバーレイが必要なら App内画面録画で可能です　それにより音声・動画サンプルを Appの処理に直接送り　作成するコンテンツを完全にコントロールできます　ゲームをプレイする次に楽しいのはゲーム実況観戦です　 App内ブロードキャストで簡単にサードパーティ配信サービスに Appをストリームし　世界中から視聴できます　我々の従来の録画機能は幅広い用途に対応していますがひとつ未対応でしたユーザーが敵を全滅させ次のレベルに進むとき　その瞬間を友人と共有したいとします　でもそのレベルが初めてで　エキサイティングな展開を想定していないと　最高の瞬間をキャプチャできません現行では全ハイライトを残すには全ゲームプレイの記録が必要です　その結果巨大な動画ができ　容量を圧迫し　短く編集するには時間もかかります　ハイライトの瞬間を全てその都度記録したいですよねさらにReplayKitがそれをやってくれて　ハイライト動画を渡してくれるとしたら？今回うれしいことに　そんな新機能をご紹介できます　クリップレコーディングです　この機能では音声や動画サンプルのローリングバッファを保存します　クリップのエクスポートが呼び出されると　直前の最長15秒の動画を書き出します　これで録画の開始のタイミングを指定する必要がなくなり　書き出しのタイミングを指定するだけで済みます　

クリップを書き出す方法は複数あります　 App内にUIボタンやコントローラ対応を追加すれば　ユーザーが手動で録画するタイミングを指定できます　ボタンのタップだけで欲しい瞬間そのものの動画が撮れます　 App内にトリガーを入れて自動録画することも可能です　これでいつでも最高の瞬間を残せます　完璧なコンボやラスボス撃退　最高速度達成などなどクリップを使って個々にカスタマイズされた体験を作成することもできます　カスタムオーバーレイを入れてそこから動画のリストを表示したり　ハイライト動画をレベルの最後に表示し共有可能にもできます　

クリップレコーディングはiOSと macOSで利用可能で強力な機能として既存の録画やキャプチャブロードキャストのAPIに加わります　他の機能と同様クリップレコーディングは HD画質で性能上のインパクトは低くプライバシー保護も組み込まれています　内部の処理はどうなっているか見てみましょう　クリップレコーディングのAPIは３つ開始停止書き出しがあり　バッファを開始するには RPScreenRecorderを呼び出し　 sharedRecorderの単一インスタンスを得ます　共有インスタンスでは　 startClipBuffering APIを呼び出せます　するとReplayKitがAppから画面録画と音声サンプルをローリングバッファに保存します　 ReplayKitは新たなサンプルを得るたび　 15秒より前のサンプルを削除します　ローリングバッファ開始後 ReplayKitは Appからの書き出し指示を待機します　 Appは書出しクリップAPIを呼ぶだけで ReplayKitがそれ以降を処理し　指定の瞬間の動画を返します　バッファが不要になった時や　例えばApp内ブロードキャスト等の ReplayKitの他の機能を利用する際　停止APIを呼べば　 ReplayKitがセッションを止めます　

これを踏まえこのAPI実装のサンプルをお見せします　このサンプルプロジェクトをご存じかもしれません昨年も使いましたから今回はクリップのコードが加わりました　コードを見てみましょう　他の録画セッションと同じく IBActionがクリップ開始ボタンと関連付けられています　このボタンはバッファしていない時は　バッファを開始すでにバッファが動いている時は停止します　次にクリップバッファの開始後を見てみます　これはバッファを開始するコードです　共有録画インスタンスが RPScreenRecorderで得られ startClipBufferingを完了ハンドラで呼び出せます　完了ハンドラの中で開始の試行中に起きたエラーに対応しておきます　 UIの更新などエラーがない場合も UIを更新して　録画を開始したことを示す必要があります　

停止のメソッドもこのサンプルにあります　ここで共有インスタンスを得ますが　この場合呼ぶのは停止APIです　完了ハンドラでも停止の試行中に起きたエラー対応をします　 UIも更新し録画停止を伝えます　

開始と停止のコードを見てきたので次はクリップの書き出しです　これは書き出しボタンと関連付いたIBActionのコードです　このアクションはユーザーが動画を作りたい時にトリガーされます　ただしこの方法に限らず App内のトリガーを使って自動に書き出すことも可能です　ここでは録画が有効になっていてボタンもその前のstartClipBuffering メソッドで有効になっていれば　 exportClip関数が呼び出されます　 exportClip APIを呼ぶには URLと動画のクリップの長さを指定します　

開始と停止のAPIと同様に　エラーには完了ハンドラで対応しておきます　エラーがなければ　指定のURLで動画を得られます　クリップにより独自のユーザー体験を構築できます　このサンプルコードではクリップは写真に保存

以上です　３つのAPIでクリップレコーディングを Appに組み込めます　クリップには所定のURLで直接アクセスでき　独自のApp内体験を構築できます　前述の通り別の方法としてゲームコントローラ対応の追加があります　ゲームコントローラのフレームワークにはクリップレコーディングが組み込まれています　ゲームコントローラから書き出したクリップは　写真Appかデスクトップに直接保存されます　そのため作成されたクリップを Appで使うには ReplayKit clips APIを実装する必要があります　 ReplayKitとゲームコントローラフレームワークを融合するにはキー値による監視を使用可能と記録中両方のプロパティに対し RPScreenRecorder上で指定するのが良いです　 RPScreenRecorderDelegateのプロトコルに従い Appの状態を必要に応じ更新できるようにします　クリップレコーディングを Appに統合するのはそれくらい簡単です　クリップレコーディングを使えばわくわくする瞬間をリアルタイムで捉えられます　たくさんのクリップを使った新たなユーザー体験を楽しみにしています　ご視聴ありがとうございます　素晴らしいWWDCを [音楽]

5:19 - Start clip buffering

// Start clip buffering API call

func startClipBuffering() {
    RPScreenRecorder.shared().startClipBuffering { error in
        if error != nil {
            print("Error attempting to start Clip Buffering")
            // Update the app recording state and UI.
            self.setClipState(active: false)
        } else {
            // No error encountered attempting to start a clip session.
            // Update the app recording state and UI.
            self.setClipState(active: true)
            
            // Set up camera View.
            self.setupCameraView()
        }
    }
}

5:46 - Stop clip buffering

// Stop clip buffering

func stopClipBuffering() {
    RPScreenRecorder.shared().stopClipBuffering { error in
        if error != nil {
            print("Error attempting to stop clip buffering")
        }
        // Update the app recording state and UI.
        self.setClipState(active: false)
        
        // Tear down camera view.
        self.tearDownCameraView()
    }
}

6:13 - Export clip button

// Export clip button

@IBAction func exportClipButtonTapped(_ sender: Any) {
    // If clip buffering is active, export clip
    if self.isActive && self.getClipButton.isEnabled {
        exportClip()
    }
}

6:41 - Export clip

// Export clip

func exportClip() {
    let clipURL = getAppTempDirectory()
    let interval = TimeInterval(5)

    print("Generating clip at URL: \(clipURL)")
    RPScreenRecorder.shared().exportClip(to: clipURL, duration: interval) { error in
        if error != nil {
            print("Error attempting to export clip")
        } else {
            // No error, so save clip at URL to photos
            self.saveToPhotos(tempURL: clipURL)
        }
    }
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。