WMR testing during development
HoloLens Anchor Sharing

HoloLens WorldAnchor persistence

Persistence is a system for saving World Anchor states across multiple runs of the same application. This can be thought of as a “save game” functionality for physical locations in the real world. An example of this is remembering where a game board is placed in the world when the application re-launches.

WorldAnchorStore は、World Anchor の保存と読み込みの基本機能を提供します。 WorldAnchorStore.GetAsync を呼び出してコールバックを提供し、WorldAnchorStore を取得します。コールバックは、返された WorldAnchorStore を保存して、再起動後の操作に使用します。

既存の World Anchor を保存するには、名前を付けて WorldAnchorStore の Save 関数を呼び出します。 以下の例を参照してください。

private void SaveAnchor()
{
    if (!this.savedAnchor) // これを 1 度だけ保存します
    {
        this.savedAnchor = this.MyWorldAnchorStore.Save("MyAnchor", MyWorldAnchor);
        if (!this.savedAnchor)
        {
            // アンカーをストアへ保存できませんでした
            // ここでエラーを処理します
        }
    }
}

読み込みは基本的に、保存の逆を行ないます。

private void LoadAnchor()
{
    this.savedAnchor = this.Load("MyAnchor", MyWorldAnchor);
    if (!this.savedAnchor)
    {
        // その名前のアンカーはストアへ保存されませんでした。  
        // ここでエラーを処理します
    }
}

ストアからアンカーを削除するには WorldAnchorStoreDelete メソッドを呼び出します。ストアからすべてのアンカーを削除するには Clear メソッドを呼び出します。

WMR testing during development
HoloLens Anchor Sharing