SpatialAnchorTransferManager.TryExportAnchorsAsync Méthode

Définition

Espace de noms:

Windows.Perception.Spatial

Exporte les ancres spatiales vers un flux, qui peut être importé ultérieurement sur un autre appareil. Cela permet aux deux appareils de raisonner sur les mêmes emplacements dans l’environnement de leurs utilisateurs.

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)

Paramètres

anchors

IIterable<IKeyValuePair<String,SpatialAnchor>>

IEnumerable<KeyValuePair<String,SpatialAnchor>>

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

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

Collection d’ancres à exporter, chacune identifiée par une clé de chaîne spécifiée par l’application.

stream

IOutputStream

Flux vers lequel exporter les ancres.

Retours

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Opération qui se déclenche une fois l’exportation terminée.

Attributs

RemoteAsyncAttribute DeprecatedAttribute

Configuration requise pour Windows

Fonctionnalités de l’application

spatialPerception

Remarques

Il incombe à l’application d’obtenir les données du flux vers l’autre appareil via son propre canal réseau.

Cette méthode génère un résultat de true si l’exportation a réussi. L’exportation peut échouer si le système de compréhension spatiale expire pendant l’exportation.

Note: Si vous utilisez JavaScript, vous ne pouvez pas créer le paramètre ancres directement, car il est de type IIterable<IKeyValuePair<Platform::String^, Windows::P erception::Spatial::SpatialAnchor^>>. Au lieu de cela, créez un composant d’assistance WinRT natif qui a une fonction CreateMap :

#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^>();
}

Vous pouvez maintenant remplir la collection d’ancres en JavaScript et la transmettre à la méthode TryExportAnchorsAsync. L’exemple de code suivant montre comment utiliser la classe SpatialAnchorHelper pour remplir la collection d’ancres.

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");
...