/// <summary>
/// Applies the specified cloud anchor to the GameObject by
/// creating or updating the native anchor.
/// to match.
/// </summary>
/// <param name="gameObject">
/// The <see cref="GameObject"/> where the cloud anchor should be
/// applied.
/// </param>
/// <param name="cloudAnchor">
/// The cloud anchor to apply.
/// </param>
/// <returns>
/// The <see cref="NativeAnchor"/> created or updated during the
/// operation.
/// </returns>
/// <exception cref="System.ArgumentNullException">
/// Thrown if <paramref name="gameObject"/> or <paramref name="cloudAnchor"/>
/// are <see langword = "null" />.
/// </exception>
/// <exception cref="PlatformNotSupportedException">
/// Thrown if the current platform is not supported by the SDK.
/// </exception>
static public NativeAnchor ApplyCloudAnchor(this GameObject gameObject, CloudSpatialAnchor cloudAnchor)
{
// Validate
if (gameObject == null)
{
throw new ArgumentNullException(nameof(gameObject));
}
if (cloudAnchor == null)
{
throw new ArgumentNullException(nameof(cloudAnchor));
}
// Placeholder
NativeAnchor nativeAnchor = null;
#if WINDOWS_UWP || UNITY_WSA
// On UWP we can just update the pointer on any existing WorldAnchor.
// Doing so will also automatically update the objects pose.
// Find or create the world anchor
nativeAnchor = gameObject.FindOrCreateNativeAnchor();
// Update the World Anchor to use the cloud-based native anchor
nativeAnchor.SetNativeSpatialAnchorPtr(cloudAnchor.LocalAnchor);
#elif UNITY_IOS || UNITY_ANDROID
// On iOS and Android we need to remove any existing native anchor,
// move the object to the new pose, and then re-apply the native anchor.
// Delete any existing native anchor
gameObject.DeleteNativeAnchor();
// Get the pose from the cloud anchor
Pose pose = cloudAnchor.GetPose();
// Move the GameObject to match the new pose
gameObject.transform.position = pose.position;
gameObject.transform.rotation = pose.rotation;
// Add the native anchor back on
nativeAnchor = gameObject.CreateNativeAnchor();
#else
throw new PlatformNotSupportedException("Unable to apply the cloud anchor. The platform is not supported.");
#endif
#if UNITY_EDITOR
#pragma warning disable CS0162 // Conditional compile statements prevent reaching this code in the unity editor
#endif
// Return the created or updated anchor
return(nativeAnchor);
#if UNITY_EDITOR
#pragma warning restore CS0162
#endif
}
