What Are Tango Poses? 什么是Tango姿势?

As your device moves through 3D space, it calculates where it is (position) andhow it’s rotated (orientation) up to 100 times per second. A single instance ofthis combined calculation is called the device’spose. The pose is anessential concept when working with motion tracking, area learning, or depthperception.


To calculate the poses, you must choose base and target frames of reference, which may use different coordinate systems. You can view apose as the translation and rotation required to transform vertices from thetarget frame to the base frame.


Here is a simplified version of a Tango pose structin C:


struct PoseData { double orientation[4]; double translation[3]; }

The two key components of a pose are:


A quaternion that defines the rotation of the target frame with respect to the base frame. 定义目标帧相对于基本帧的旋转的四元数。 A 3D vector that defines the translation of the target frame with respect to the base frame. 定义目标帧相对于基本帧的平移的3D向量。

An actual pose struct contains other fields, such as a timestamp and a copy ofthe frame pair, as you’ll see below.


Note: The examples on this page use the C API, but function calls and datastructures are similar for java. In Unity, there are PRefabs which handle a lotof these details for you. 注意:此页面上的示例使用C API,但对于Java,函数调用和数据结构类似。在Unity中,有预处理为你处理很多这些细节。 Pose data 姿势数据

You can request pose data in two ways: 您可以通过两种方式请求姿势数据: Request Method #1 请求方法#1

Poll for poses using TangoService_getPoseAtTime().This returns the pose closest to a given timestamp from the base to the targetframe. Here is the code for this function in the C API:

使用TangoService_getPoseAtTime()调查姿势。这将返回最接近给定时间戳的从基址到目标帧的姿态。这里是C API中此函数的代码:

TangoErrorType TangoService_getPoseAtTime( double timestamp, TangoCoordinateFramePair frame_pair, TangoPoseData* pose);

The TangoCoordinateFramePairstruct specifies the base frame and the target frame.


Note: If you are making an augmented reality app, we recommend that you useTangoService_getPoseAtTime() orTangoSupport_getPoseAtTime() because, in addition to polling for poses, they allow you to align the pose timestamps with the video frames.


The following code gets a pose of the device frame with respect to the start-of-service frame:


TangoPoseData pose_start_service_T_device; TangoCoordinateFramePair frame_pair; frame_pair.base = TANGO_COORDINATE_FRAME_START_OF_SERVICE; frame_pair.target = TANGO_COORDINATE_FRAME_DEVICE; TangoService_getPoseAtTime( timestamp, frame_pair, &pose_start_service_T_device);

In this example, including the names of the base and target frames in the posevariable name makes the name more descriptive: 在此示例中,在姿势变量名称中包括基准和目标框架的名称使名称更具描述性:

TangoPoseData pose_start_service_T_device;

Request Method #2 请求方法#2

Receive pose updates as they become available. To do so,attach an onPoseAvailable() callback toTangoService_connectOnPoseAvailable().This sample is from ourhello_motion_trackingexample project and can be found in thetango_handler.cc file:


TangoCoordinateFramePair pair; pair.base = TANGO_COORDINATE_FRAME_START_OF_SERVICE; pair.target = TANGO_COORDINATE_FRAME_DEVICE; if (TangoService_connectOnPoseAvailable(1, &pair, onPoseAvailable) != TANGO_SUCCESS) { LOGE(“TangoHandler::ConnectTango, connectOnPoseAvailable error.”); std::exit(EXIT_SUCCESS);

In both cases, you receive a TangoPoseData struct:


typedef struct TangoPoseData { int version; double timestamp; // In milliseconds double orientation[4]; // As a quaternion double translation[3]; // In meters TangoPoseStatusType status_code; TangoCoordinateFramePair frame; int confidence; // Currently unused float accuracy; // Currently unused } TangoPoseData;

Pose status 姿势状态

TangoPoseData contains a state, denoted by theTangoPoseStatusTypeenum, which provides information about the status of the pose estimationsystem. The available TangoPoseStatusType members are:



INITIALIZING: The motion tracking system is either starting or recovering froman invalid state, and the pose data should not be used.

VALID: The system believes the poses being returned are valid and should beused.

INVALID: The system has encountered difficulty of some kind, so poseestimations are likely incorrect.

UNKNOWN: The system is in an unknown state.

INITIALIZING:运动跟踪系统正在启动或从无效状态恢复,并且不应使用姿态数据。 VALID:系统认为返回的姿势有效,应该使用。 INVALID:系统遇到某种困难,因此姿态估计可能不正确。 UNKNOWN:系统处于未知状态。

Lifecycle of pose status 姿势状态的生命周期 Figure 1: Tango Pose data lifecycle 图1:探戈姿势数据生命周期

The TANGO_POSE_INITIALIZING status code indicates that the Tangoframework is initializing and pose data is not yet available. If you are usingcallbacks, you will receive only one pose update with the status code set toTANGO_POSE_INITIALIZING while the framework is initializing.


After initialization finishes, poses are in the TANGO_POSE_VALID state. If youare using callbacks, you will receive updates as frequently as they areavailable.


If the system encounters difficulty and enters the TANGO_POSE_INVALID state,recovery depends on your configuration during initialization. Ifconfig_enable_auto_recovery is set toTrue, the system immediately resetsthe motion tracking system and enters theTANGO_POSE_INITIALIZING state. Ifconfig_enable_auto_recovery is set toFalse, pose data remains in theTANGO_POSE_INVALID state and no updates are received until you callTangoService_resetMotionTracking().


Using pose status 使用姿势状态

Your application should react to the status being returned within the posedata. For example, wait until the pose data you are interested in becomes validbefore starting interactions in your application. If the pose becomes invalid,pause interactions until after the system recovers. Depending on yourapplication, what you do after the system recovers will vary. If you are usingmotion tracking alone, you can simply resume your application. If you are usingarea learning or ADFs, instruct your user to move around until the device canlocalize itself. 您的应用程序应对姿势数据中返回的状态做出反应。例如,等到您感兴趣的姿势数据在您的应用程序中开始交互之前变得有效。如果姿势无效,请暂停交互,直到系统恢复。根据您的应用程序,您在系统恢复后执行的操作将有所不同。如果您仅使用运动跟踪,则可以简单地恢复应用程序。如果您使用区域学习或ADF,请指导您的用户移动,直到设备可以本地化。