Google I/O にご参加いただきありがとうございました。AR コンテンツをオンデマンドで視聴できます。

このページは Cloud Translation API によって翻訳されました。

Android をターゲットとする AR Foundation で録画中にカスタムデータを追加する

Recording & Playback API を使用すると、セッションを録画して、リアルタイムのカメラフィードの代わりに使用できます。ただし、これらの記録には動画とセンサーデータのみが含まれます。また、セッションの録音にカスタムデータを追加して、あたかもカメラ画像の一部であるかのように、再生中にそのデータを返すこともできます。

ARCore では、録画にカスタムデータが自動的に含まれることはありません。むしろ、録画中に ARCore フレームにカスタムデータを追加し、再生中にフレームから同じデータを取得できます。セッションを再生したときに、ユーザーが期待するデータを返すようにアプリをプログラミングするかどうかは、デベロッパー次第です。

カスタムデータのユースケース

録画にカスタムデータを追加すると、AR アプリの可能性が広がります。具体的なユースケースは次のとおりです。

外出先で AR を活用

これまでは、ユーザーが AR エクスペリエンスにアクセスできるのは適切な場所とタイミングでのみでした。AR ランプをリビングルームに設置する場合は、実際にその場所に立ってランプがどのように表示されるかを確認する必要があります。カスタムトラックでは、リビングルームを 1 回録画して、いつでもバーチャルな家具を追加することが可能です。

AR エクスペリエンスを共同作成

ライブセッションが不要な場合、ユーザーは AR 編集の選択肢が多くなり、いつでもどこでも独自の AR コンテンツを作成してアクセスできます。たとえば、特定の環境を録画したり、拡張現実効果を追加したり、友人と共有したりできます。

前提条件

続行する前に、AR の基本的なコンセプトと ARCore セッションを構成する方法を理解しておいてください。

カスタムデータで記録を初期化する

カスタムデータを使用して記録を初期化する手順は次のとおりです。録画セッションの開始、停止、確認については、AR セッションを録画、再生するをご覧ください。

ARCoreRecordingConfig を取得します。
カスタム UUID を使用して新しい Track を作成します。すべてのカスタムデータはここに保存されます。
セッション設定時に作成した ARCoreRecordingConfig に Track を追加します。

// Initialize a new track with a custom UUID.
// Make sure to save the UUID because it is the ID that you will use
// to get your data back during playback.
var track = new Track {
 Id = Guid.Parse("de5ec7a4-09ec-4c48-b2c3-a98b66e71893") // from UUID generator
};

// Add the Track to the recordingConfig.
// recordingConfig must already be configured.
List<Track> tracks = new List<Track>();
tracks.Add(track);
recordingConfig.Tracks = tracks;

新しいトラックはすべて個別の録音として扱われ、録音された各トラックは固有の UUID を占有します。

追加データを使用してトラックを設定する

セッションの録音を説明する追加データでトラックを構成します。たとえば、トラックに「タグ」を付けるには、「このセッションは午後にモールで録画されました」のように、セッションの録画場所と時刻を記載したメモを追加できます。

// Set additional data on this track.
// For example, describe where you recorded the session.
byte[] metadata = ...
track.Metadata = metadata;

MIME タイプを指定してトラックを設定する

外部ツールとの互換性を確保するために、トラックに記録されるデータの種類を記述する MIME タイプでトラックを構成します。

タイプを指定しない場合、データは application/text に分類されます。ARCore は、データを読み取るときに MIME タイプを無視します。

// Set a MIME type for compatibility with external tools.
track.MimeType = "text/csv";

カスタムデータトラックの記録

すべてのカスタムトラックデータはフレームに記録されます。データをフレームに記録した時刻は、再生中にデータが返される時刻です。たとえば、00:07:02 で値「A」を指定して RecordTrackData() を呼び出した場合、トラックの再生時に 00:07:02 のマークで「A」が返されます。

カスタムデータトラックを記録するには、RecordTrackData() を呼び出します。

// Place an AR lamp in a room.
if (placeLampButtonWasPressed) {
  // Convert the lamp data into a byte array.
  var lampData = new byte[] { (byte) Lamp.FLOOR };  // a floor lamp
  recordingManager.RecordTrackData(trackGuid, lampData);
}

カスタムデータトラックの再生

再生中にセッションの録音からカスタムデータを抽出します。

再生を初期化する

カスタムデータを使用した再生の初期化は、通常のセッション録音の再生の初期化と同じです。

カスタムデータを返す

GetUpdatedTrackData() を呼び出して、フレームに記録されたカスタムデータを取得します。同じフレームから複数のトラックデータを取得することもできます。たとえば、録画中に同じフレームで RecordTrackData() を 2 回呼び出すと、再生中に TrackData のインスタンスが 2 回返されます。

// Fetch the data recorded on a select frame and place it in a
// container object.
var trackDataList = recordingManager.GetUpdatedTrackData(trackGuid);

TrackData がコンテナオブジェクトに取り込まれたら、カスタムデータのバイトを抽出します。

// Extract the bytes of custom data from the list of track data.
foreach (TrackData trackData in trackDataList) {
  var data = trackData.Data;
  Lamp lamp = Lamp.fromByte(data[0]); // This is the lamp!
}

次のステップ

録画と再生の Codelab で、録画と再生機能を使用して独自のアプリを作成する方法を学習します。