SpatialAnchorTransferManager.TryExportAnchorsAsync メソッド

定義

名前空間:

Windows.Perception.Spatial

空間アンカーをストリームにエクスポートします。これは後で別のデバイスにインポートできます。 これにより、両方のデバイスがユーザーの周囲の同じ場所について推論できるようになります。

public:
 static IAsyncOperation<bool> ^ TryExportAnchorsAsync(IIterable<IKeyValuePair<Platform::String ^, SpatialAnchor ^> ^> ^ anchors, IOutputStream ^ stream);

/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Deprecated("Use SpatialEntityStore instead of SpatialAnchorTransferManager. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 262144, "Windows.Foundation.UniversalApiContract")]
 static IAsyncOperation<bool> TryExportAnchorsAsync(IIterable<IKeyValuePair<winrt::hstring, SpatialAnchor const&>> const& anchors, IOutputStream const& stream);

[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Deprecated("Use SpatialEntityStore instead of SpatialAnchorTransferManager. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 262144, "Windows.Foundation.UniversalApiContract")]
public static IAsyncOperation<bool> TryExportAnchorsAsync(IEnumerable<KeyValuePair<string,SpatialAnchor>> anchors, IOutputStream stream);

function tryExportAnchorsAsync(anchors, stream)

Public Shared Function TryExportAnchorsAsync (anchors As IEnumerable(Of KeyValuePair(Of String, SpatialAnchor)), stream As IOutputStream) As IAsyncOperation(Of Boolean)

パラメーター

anchors

IIterable<IKeyValuePair<String,SpatialAnchor>>

IEnumerable<KeyValuePair<String,SpatialAnchor>>

IIterable<IKeyValuePair<Platform::String,SpatialAnchor>>

IIterable<IKeyValuePair<winrt::hstring,SpatialAnchor>>

エクスポートするアンカーのコレクション。それぞれ、アプリで指定された文字列キーによって識別されます。

stream

IOutputStream

アンカーをエクスポートするストリーム。

戻り値

IAsyncOperation<Boolean>

IAsyncOperation<bool>

エクスポートが完了するとトリガーされる操作。

属性

RemoteAsyncAttribute DeprecatedAttribute

Windows の要件

アプリの機能

spatialPerception

注釈

ストリーム内のデータを、独自のネットワーク チャネルを介して他のデバイスに取得するのはアプリの責任です。

このメソッドは、エクスポートが成功した場合に true の結果を生成します。 エクスポート中に空間理解システムがタイムアウトすると、エクスポートが失敗する可能性があります。

メモ： JavaScript を使用している場合、 anchors パラメーターは IIterable<IKeyValuePair<Platform::String^、Windows::P erception::Spatial::SpatialAnchor^>> 型であるため、直接作成することはできません。 代わりに、 CreateMap 関数を持つネイティブ WinRT ヘルパー コンポーネントを作成します。

#include <winrt/Windows.Foundation.Collections.h>
#include <winrt/Windows.Perception.Spatial.h>

using namespace winrt;
using namespace Windows::Foundation::Collections;
using namespace Windows::Perception::Spatial;

IMap<winrt::hstring, SpatialAnchor> CreateMap()
{
    return winrt::single_threaded_map<winrt::hstring, SpatialAnchor>();
}

#include "pch.h"
#include "SpatialAnchorHelper.h"

using namespace SpatialHelper;
using namespace Platform;

Windows::Foundation::Collections::IMap<Platform::String^, Windows::Perception::Spatial::SpatialAnchor^>^ SpatialAnchorHelper::CreateMap()
{
    return ref new Platform::Collections::Map<Platform::String^, Windows::Perception::Spatial::SpatialAnchor^>();
}

これで、JavaScript で anchors コレクションを設定し、TryExportAnchorsAsync メソッドに渡すことができます。 次のコード例は、SpatialAnchorHelper クラスを使用してアンカー コレクションを設定する方法を示しています。

waitForPositionalTracking(function () {
	var spatialAnchor = Windows.Perception.Spatial.SpatialAnchor.tryCreateRelativeTo(stationaryRef.coordinateSystem);

	if (isLocatableRelativeToUser(spatialAnchor)) {
		var map = SpatialHelper.SpatialAnchorHelper.createMap();
		map.insert("test", spatialAnchor);

		var stream = Windows.Storage.Streams.InMemoryRandomAccessStream();

		console.log("Exporting spatial anchor");
		var exportWatch = new Stopwatch();
		Windows.Perception.Spatial.SpatialAnchorTransferManager.tryExportAnchorsAsync(map.getView(), stream.getOutputStreamAt(0)).then(
            function (succeeded) {
                if (succeeded) {
                    console.log("Exported " + stream.size + " bytes to stream.  Elapsed time: " + exportWatch.stop() + " seconds");
...