Unreal SDK With Swift 2.0 For Enterprise Developers (宇叠引用)

简介

BodyTracking功能为开发者提供了获取多个Swift Tracker数据的能力。通过BodyTracking相关接口，开发者可以获取到各个SwiftTracker节点的姿态数据，连接状态和电量等。

使用流程

使用BodyTracking功能前，需要在Editor的ProjectSettings->Plugins->PICOSettings->Feature中开启Enable Body Tracking选项。

全身动捕模式

初始追踪模式为双腿如果希望开启全身动捕模式，则需要调用接口切换到Full Body模式

接口说明

PXR_GetBodyTrackingPose

通过该接口可以获取Tracker的所有追踪数据

/**
* GetBodyTrackingPose
* @param BodyTrackingData     (Out)The Array of BodyTrackingData.
* @return true to indicate that the function call was successful.
*/
UFUNCTION(BlueprintCallable, Category = "PXR|PXRInput")
static bool PXR_GetBodyTrackingPose(TArray<FPxrBodyTrackingTransform>& BodyTrackingData);

输出：

• Body Tracking Data：追踪数据的数组，数组的序号对应一个固定的追踪节点，对应关系可以参考此枚举：EPxrBodyTrackerRole ：

UENUM(BlueprintType)
enum class EPxrBodyTrackerRole : uint8
{
   PxrPelvis = 0 UMETA(DisplayName = "Pelvis"),
   Pxr_LEFT_HIP = 1 UMETA(DisplayName = "LEFT_HIP"),
   Pxr_RIGHT_HIP = 2 UMETA(DisplayName = "RIGHT_HIP"),
   Pxr_SPINE1 = 3 UMETA(DisplayName = "SPINE1"),
   Pxr_LEFT_KNEE = 4 UMETA(DisplayName = "LEFT_KNEE"), 
   Pxr_RIGHT_KNEE = 5 UMETA(DisplayName = "RIGHT_KNEE"),
   Pxr_SPINE2 = 6 UMETA(DisplayName = "SPINE2"),
   Pxr_LEFT_ANKLE = 7 UMETA(DisplayName = "LEFT_ANKLE"),
   Pxr_RIGHT_ANKLE = 8 UMETA(DisplayName = "RIGHT_ANKLE"),
   Pxr_SPINE3 = 9 UMETA(DisplayName = "SPINE3"),
   Pxr_LEFT_FOOT = 10 UMETA(DisplayName = "LEFT_FOOT"),
   Pxr_RIGHT_FOOT = 11 UMETA(DisplayName = "RIGHT_FOOT"),
   Pxr_NECK = 12 UMETA(DisplayName = "NECK"),
   Pxr_LEFT_COLLAR = 13 UMETA(DisplayName = "LEFT_COLLAR"),
   Pxr_RIGHT_COLLAR = 14 UMETA(DisplayName = "RIGHT_COLLAR"),
   Pxr_HEAD = 15 UMETA(DisplayName = "HEAD"),
   Pxr_LEFT_SHOULDER = 16 UMETA(DisplayName = "LEFT_SHOULDER"),
   Pxr_RIGHT_SHOULDER = 17 UMETA(DisplayName = "RIGHT_SHOULDER"),
   Pxr_LEFT_ELBOW = 18 UMETA(DisplayName = "LEFT_ELBOW"),
   Pxr_RIGHT_ELBOW = 19 UMETA(DisplayName = "RIGHT_ELBOW"),
   Pxr_LEFT_WRIST = 20 UMETA(DisplayName = "LEFT_WRIST"),
   Pxr_RIGHT_WRIST = 21 UMETA(DisplayName = "RIGHT_WRIST"),
   Pxr_LEFT_HAND = 22 UMETA(DisplayName = "LEFT_HAND"),
   Pxr_RIGHT_HAND = 23 UMETA(DisplayName = "RIGHT_HAND"),
   Pxr_NONE_ROLE = 24 UMETA(DisplayName = "NONE_ROLE")
};

• PxrBodyTrackingTransform:追踪节点的变换数据

struct FPxrBodyTrackingTransform
{
   GENERATED_USTRUCT_BODY()
   
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
    int64 TimeStamp;
    /** bone name. if bone == NONE_ROLE, this bone is not calculated */
    UPROPERTY(EditAnywhere, BlueprintReadWrite,  Category = "PXR|FBodyTrackingData")
    EPxrBodyTrackerRole bone;
    /** bone local transform */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
    FTransform LocalPose;              
    /** velocity of x,y,z */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
    FVector velo;                     
    /** acceleration of x,y,z */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
    FVector acce;                     
    /** angular velocity of x,y,z */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
    FVector wvelo;                    
    /** angular acceleration of x,y,z */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
    FVector wacce;                    // 
    /** multiple actions can be supported at the same time by means of OR BodyActionList */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
    EPxrBodyActionList  bodyAction;              
};

返回值：

• 是否获取成功

PXR_GetBodyTrackingPoseByRole

通过该接口可以获取指定位置节点Tracker的追踪数据

/**
* GetBodyTrackingPoseByRole
* @param RoleType     (In)  BodyTracker Role,such as ANKLE.
* @param RoleBodyTrackingData     (Out)  The BodyTrackingData of selected role.
* @return true to indicate that the function call was successful.
*/
UFUNCTION(BlueprintCallable, Category = "PXR|PXRInput")
static bool PXR_GetBodyTrackingPoseByRole(EPxrBodyTrackerRole RoleType,FPxrBodyTrackingTransform& RoleBodyTrackingData);

输入：

• World to Meters Scale：输入引擎当前的缩放比例

• Role Type：当前查询的节点

UENUM(BlueprintType)
enum class EPxrBodyTrackerRole : uint8
{
   PxrPelvis = 0 UMETA(DisplayName = "Pelvis"),
   Pxr_LEFT_HIP = 1 UMETA(DisplayName = "LEFT_HIP"),
   Pxr_RIGHT_HIP = 2 UMETA(DisplayName = "RIGHT_HIP"),
   Pxr_SPINE1 = 3 UMETA(DisplayName = "SPINE1"),
   Pxr_LEFT_KNEE = 4 UMETA(DisplayName = "LEFT_KNEE"), 
   Pxr_RIGHT_KNEE = 5 UMETA(DisplayName = "RIGHT_KNEE"),
   Pxr_SPINE2 = 6 UMETA(DisplayName = "SPINE2"),
   Pxr_LEFT_ANKLE = 7 UMETA(DisplayName = "LEFT_ANKLE"),
   Pxr_RIGHT_ANKLE = 8 UMETA(DisplayName = "RIGHT_ANKLE"),
   Pxr_SPINE3 = 9 UMETA(DisplayName = "SPINE3"),
   Pxr_LEFT_FOOT = 10 UMETA(DisplayName = "LEFT_FOOT"),
   Pxr_RIGHT_FOOT = 11 UMETA(DisplayName = "RIGHT_FOOT"),
   Pxr_NECK = 12 UMETA(DisplayName = "NECK"),
   Pxr_LEFT_COLLAR = 13 UMETA(DisplayName = "LEFT_COLLAR"),
   Pxr_RIGHT_COLLAR = 14 UMETA(DisplayName = "RIGHT_COLLAR"),
   Pxr_HEAD = 15 UMETA(DisplayName = "HEAD"),
   Pxr_LEFT_SHOULDER = 16 UMETA(DisplayName = "LEFT_SHOULDER"),
   Pxr_RIGHT_SHOULDER = 17 UMETA(DisplayName = "RIGHT_SHOULDER"),
   Pxr_LEFT_ELBOW = 18 UMETA(DisplayName = "LEFT_ELBOW"),
   Pxr_RIGHT_ELBOW = 19 UMETA(DisplayName = "RIGHT_ELBOW"),
   Pxr_LEFT_WRIST = 20 UMETA(DisplayName = "LEFT_WRIST"),
   Pxr_RIGHT_WRIST = 21 UMETA(DisplayName = "RIGHT_WRIST"),
   Pxr_LEFT_HAND = 22 UMETA(DisplayName = "LEFT_HAND"),
   Pxr_RIGHT_HAND = 23 UMETA(DisplayName = "RIGHT_HAND"),
   Pxr_NONE_ROLE = 24 UMETA(DisplayName = "NONE_ROLE")
};

输出：

• Role Body Tracking Data：当前节点的追踪数据

struct FPxrBodyTrackingTransform
{
   GENERATED_USTRUCT_BODY()
   
  UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
int64 TimeStamp;
/** bone name. if bone == NONE_ROLE, this bone is not calculated */
UPROPERTY(EditAnywhere, BlueprintReadWrite,  Category = "PXR|FBodyTrackingData")
EPxrBodyTrackerRole bone;
/** bone local transform */
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
FTransform LocalPose;              
/** velocity of x,y,z */
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
FVector velo;                     
/** acceleration of x,y,z */
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
FVector acce;                     
/** angular velocity of x,y,z */
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
FVector wvelo;                    
/** angular acceleration of x,y,z */
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
FVector wacce;                    // 
/** multiple actions can be supported at the same time by means of OR BodyActionList */
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FBodyTrackingData")
EPxrBodyActionList  bodyAction;              
};

返回值：

• 是否获取成功

PXR_GetFitnessBandConnectState

通过该接口可以获取当前所有Tracker的连接状态

/**
* GetFitnessBandConnectState
* @param State    (out)  FitnessBandConnectState.
* @return true to indicate that the function call was successful.
*/
UFUNCTION(BlueprintCallable,Category="PXR|PXRInput")
static bool PXR_GetFitnessBandConnectState(FFitnessBandConnectState& State);

输出：

• State：当前的连接状态：

USTRUCT(BlueprintType)
struct FFitnessBandConnectState
{
   GENERATED_USTRUCT_BODY()
   /** The number of trackers currently connected  */
   UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FFitnessBandConnectState")
   uint8 Num;
   /** The Array of trackers ID currently connected */
   UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|FFitnessBandConnectState")
   TArray<uint8> TrackerIDArray;
};

返回值：

• 是否获取成功

PXR_GetFitnessBandBattery

通过该接口可以获取指定Tracker的电量值

/**
* GetFitnessBandBattery
* @param TrackerId    (In)  BodyTrackingDevice Id
* @param Battery      (Out) battery power 1-5
* @return true to indicate that the function call was successful.
*/
UFUNCTION(BlueprintCallable,Category="PXR|PXRInput")
static bool PXR_GetFitnessBandBattery(int32 TrackerId, int32& Battery);

输入：

• Tracker ID：当前查询电量的TrackerID

输出：

• Battery：当前查询Tracker的电量（1-5）

返回值：

• 是否获取成功

PXR_GetFitnessBandCalibState

通过该接口可以获取当前系统的校准状态

/**
* GetFitnessBandCalibState
* @param CalibrateState       (Out)  CalibrateState.
* @return true to indicate that the function call was successful.
*/
UFUNCTION(BlueprintCallable,Category="PXR|PXRInput")
static bool PXR_GetFitnessBandCalibState(int32& CalibrateState);

输出：

• Calibrate State：当前系统的校准状态

  • 0：未校准

  • 1：已校准

返回值：

• 是否获取成功

PXR_LaunchFitnessBandCalibrationAPP

通过该接口可以启动校准应用

/**
* LaunchFitnessBandCalibrationAPP
* @return true to indicate that the function call was successful.
*/
UFUNCTION(BlueprintCallable,Category="PXR|PXRInput")
static bool PXR_LaunchFitnessBandCalibrationAPP();

返回值：

• 是否启动成功

PXR_SetSwiftMode(ESwiftMode Mode);

/**
* Set Swift Tracking Mode
* @param Mode      (In)An enum representing the Swift Tracking Mode
* @return true to indicate that the function call was successful.
*/
UFUNCTION(BlueprintCallable,Category="PXR|PXRInput")
static bool PXR_SetSwiftMode(ESwiftMode Mode);

输入：

• Mode：当前追踪模式

UENUM(BlueprintType)
enum class ESwiftMode: uint8
{
    SWIFT_DEFAULT = 0 UMETA(DisplayName = "Default"), //默认腿部追踪模式
    SWIFT_FULLBODY = 1 UMETA(DisplayName = "Full Body"),//全身动捕模式
};

返回值：

• 是否设置成功

PXR_SetBodyTrackingBoneLength(const FBodyTrackingBoneLength& BoneLength);

/**
* Set BodyTracking BoneLength
* @param BoneLength    (In)Bone Length,such as head or neck
* @return true to indicate that the function call was successful.
*/
UFUNCTION(BlueprintCallable,Category="PXR|PXRInput")
static bool PXR_SetBodyTrackingBoneLength(const FBodyTrackingBoneLength& BoneLength);

输入：

• Bone Length：

USTRUCT(BlueprintType)
struct FBodyTrackingBoneLength
{
    GENERATED_USTRUCT_BODY()
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float headLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float neckLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float torsoLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float hipLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float upperLegLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float lowerLegLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float footLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float shoulderLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float upperArmLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float lowerArmLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float handLen;
};

返回值：

• 是否设置成功

Swift 2.0 Preview版本新增接口说明

PXR_StartBodyTrackingCalibApp

通过该接口可以拉起校准应用

UFUNCTION(BlueprintCallable, Category = "PXR|BodyTracking")
static bool PXR_StartBodyTrackingCalibApp();

返回值：

• 是否拉起成功

全身动捕相关接口

PXR_GetBodyTrackingSupported

查询当前设备是否支持人体追踪能力

输出：

• Supported：当前设备是否支持人体追踪

  • true：支持

  • false：不支持

• Supported Modes：当前支持模式的枚举数组

  • PXR BTM DISABLE：无效模式

  • PXR BTM WITH SWIFT：Swift 模式

  • PXR BTM WITHOUT SWIFT：无Swift 模式（暂不支持该模式）

返回值：

• 接口是否调用成功

PXR_GetBodyTrackingState

获取Tracker的动捕数据状态及异常原因

输出：

• Is Tracking：是否追踪中

  • true：追踪中

  • false：追踪丢失

• Tracking State：追踪状态

  • Current Tracking Mode:

UENUM(BlueprintType)
enum class EPXRBodyTrackingMode : uint8
{
    PXR_BTM_DISABLE = 0,
    PXR_BTM_WITH_SWIFT = 1,
    PXR_BTM_WITHOUT_SWIFT = 2,
};

• Tracking State Code:系统追踪状态码

UENUM(BlueprintType)
enum class EPXRTrackingStateCode : uint8
{
    PXR_MT_SUCCESS           = 0,
    PXR_MT_FAILURE           = (uint8)-1,
    PXR_MT_MODE_NONE          = (uint8)-2,
    PXR_MT_DEVICE_NOT_SUPPORT   = (uint8)-3,
    PXR_MT_SERVICE_NEED_START   = (uint8)-4,
    PXR_MT_ET_PERMISSION_DENIED  = (uint8)-5,
    PXR_MT_FT_PERMISSION_DENIED  = (uint8)-6,
    PXR_MT_MIC_PERMISSION_DENIED = (uint8)-7,
    PXR_MT_SYSTEM_DENIED       = (uint8)-8,
    PXR_MT_UNKNOW_ERROR           = (uint8)-9
};

• Tracking Status Code:人体追踪状态码

UENUM(BlueprintType)
enum class EPXRBodyTrackingStatusCode : uint8
{
    PXR_BODYTRACKING_INVALID = 0,
    PXR_BODYTRACKING_VALID = 1,
    PXR_BODYTRACKING_LIMITED = 2
};

• Tracking Error Code:人体追踪错误码

UENUM(BlueprintType)
enum class EPXRBodyTrackingErrorCode : uint8
{
    PXR_BT_ERROR_INNER_EXCEPTION = 0,
    PXR_BT_ERROR_TRACKER_NOT_CALIBRATED = 1,
    PXR_BT_ERROR_TRACKER_NUM_NOT_ENOUGH = 2,
    PXR_BT_ERROR_TRACKER_STATE_NOT_SATISFIED = 3,
    PXR_BT_ERROR_TRACKER_PERSISTENT_INVISIBILITY = 4,
    PXR_BT_ERROR_TRACKER_DATA_ERROR = 5,
    PXR_BT_ERROR_USER_CHANGE = 6,
    PXR_BT_ERROR_TRACKING_POSE_ERROR = 7,
};

• Connected Band Count:已连接的Swift绑带数量

• Connected Fitness Band:已连接的Swift绑带id数组

返回值：

• 接口是否调用成功

PXR_StartBodyTracking

开始人体追踪

输入：

• StartMode：以什么模式开始

  • PXR BTM DISABLE：无效模式

  • PXR BTM WITH SWIFT：Swift 模式

  • PXR BTM WITHOUT SWIFT：无Swift 模式（暂不支持该模式）

• SwiftMode：Swift模式选择

UENUM(BlueprintType)
enum class ESwiftMode: uint8
{
    SWIFT_DEFAULT = 0 UMETA(DisplayName = "Default"), //默认腿部追踪模式
    SWIFT_FULLBODY = 1 UMETA(DisplayName = "Full Body"),//全身动捕模式
};

• Bone Length：骨长数据，缺省则使用系统默认值

USTRUCT(BlueprintType)
struct FBodyTrackingBoneLength
{
    GENERATED_USTRUCT_BODY()
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float headLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float neckLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float torsoLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float hipLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float upperLegLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float lowerLegLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float footLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float shoulderLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float upperArmLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float lowerArmLen;
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    float handLen;
};

• Other Mode：默认为-1，特殊需求预留扩展参数

PXR_StopBodyTracking

结束人体追踪

输入：

• Stop Info：预留参数，不需要设置

返回值：

• 接口是否调用成功

PXR_GetBodyTrackingData

获取人体追踪数据

输入：

• World to Meters Scale：单位米缩放比，默认为100

• GetInfo

  • Display Time：预测时间，缺省则使用系统默认预测时间

  • DataFlags：用于过滤所需数据类型

UENUM(BlueprintType)
enum class EPXRBodyTrackingGetDataFlags : uint8
{
    PXR_BODY_NONE = 0,
    PXR_BODY_POSE = 1 << 0,
    PXR_BODY_ACTION = 1 << 1,
    PXR_BODY_VELO_ACC = 1 << 2,
};

输出：

• BodyTracking Data：各个追踪节点数据的数组

USTRUCT(BlueprintType)
struct FPxrBodyTrackingTransform
{
    GENERATED_USTRUCT_BODY()
    
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    int64 TimeStamp;
    /** bone name. if bone == NONE_ROLE, this bone is not calculated */
    UPROPERTY(EditAnywhere, BlueprintReadWrite,  Category = "PXR|BodyTrackingData")
    EPxrBodyTrackerRole bone;
    /** bone local transform */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    FTransform LocalPose;
    /** bone Global transform */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    FTransform GlobalPose;
    /** velocity of x,y,z */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    FVector velo;                     
    /** acceleration of x,y,z */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    FVector acce;                     
    /** angular velocity of x,y,z */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    FVector wvelo;                    
    /** angular acceleration of x,y,z */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    FVector wacce;                    // 
    /** multiple actions can be supported at the same time by means of OR BodyActionList */
    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "PXR|BodyTrackingData")
    EPxrBodyActionList  bodyAction;              

    FPxrBodyTrackingTransform()
       :TimeStamp(0),
       bone(EPxrBodyTrackerRole::PxrPelvis),
         LocalPose(FTransform()),
         GlobalPose(FTransform()),
         velo(FVector::ZeroVector),
         acce(FVector::ZeroVector),
         wvelo(FVector::ZeroVector),
         wacce(FVector::ZeroVector),
         bodyAction(EPxrBodyActionList::NoneAction)
    {
    }
};

返回值：

• 接口是否调用成功

独立追踪相关接口

独立追踪与全身动捕相关接口无关，不需要调用StartBodyTracking，但是仍然对校准有要求。

PXR_GetMotionTrackerConnectState

获取独立追踪连接状态

输出：

• Connect State：连接状态

  • Tracker Sum：追踪节点数量

  • Trackers SN Array：追踪节点SN数组

返回值：

• 接口是否调用成功

PXR_GetMotionTrackerType

已连接的追踪器类型

输出：

• Tracker Type：追踪类型

  • PXR SWIFT 1

  • PXR SWIFT 2

返回值：

• 接口是否调用成功

PXR_GetMotionTrackerMode

获取当前追踪模式

输出：

• Tracker Mode：追踪模式

  • FULL BODY：全身动捕模式

  • STAND ALONE TRACKER：独立追踪模式

返回值：

• 接口是否调用成功

PXR_GetMotionTrackerLocations

获取独立追踪模式下追踪器位置

输入：

• World to Meters Scale：单位米缩放比，默认为100

• Tracker SN：要获取位置数据的追踪器SN

输出：

• Locations：SN对应的位置数据

  • Tracker SN：数据所对应的SN

  • Local Pose：与HMD相同参考系下姿态

  • Global Pose：系统全局参考系下姿态，无特殊需求不建议使用

返回值：

• 接口是否调用成功

示例工程

Release

30MB

BodyTrackingDemo 4.27.zip

archive

Open

30MB

BodyTrackingDemo 5.2.zip

archive

Open

Full Body 模式

21MB

FullBody.mp4

Open

Swift 2.0 Preview（Full Body&& StandAlone Tracker）

10MB

Swift2PreviewDemo427.7z

Open

Demo提供了一个示例Pawn（BP_PawnSwift_2），设置MotionType可以切换Full Body和Stand_Alone_Tracker模式

Stand_Alone_Tracker模式

13MB

StandAloneTracker.mp4

Open

Swift 2.0 Preview SDK

28MB

UE_5.2-2.3.4_B173-20231102.zip

archive

Open

27MB

UE_4.27-2.3.4_B173-20231102.zip

archive

Open

28MB

UE_5.1-2.3.4_B173-20231102.zip

archive

Open