|
1 | | -This article records the changes to the PICO Unity Integration SDK in version 3.2.0. |
| 1 | +This article records the changes to the PICO Unity Integration SDK in version 3.3.0. |
| 2 | +## Download the SDK |
| 3 | +Download the latest version of the PICO Unity Integration SDK from the [Download](https://developer-global.pico-interactive.com/resources/#sdk) screen. |
2 | 4 | ## What's new |
3 | | -Released on: May 29, 2025 |
4 | | -Required PICO device's system version: 5.13.0 or later (PICO Neo3 and PICO 4 series devices are currently not supported) |
5 | | -The newly added content is as follows: |
| 5 | +Released on: September 18, 2025 |
| 6 | +Required PICO device's system version: 5.13.0 for PICO 4 series, 5.14.0 or later for PICO 4 Ultra series |
| 7 | +**Add** |
6 | 8 | | **Module** | **Description** | |
7 | 9 | | --- | --- | |
8 | | -| General | Added the [PICO XR Portal](https://developer.picoxr.com/document/unity/pico-xr-portal/) - a developer portal consisting of four sections: Configs, Tools, Samples, and About. | |
9 | | -| | [Project Validation](https://developer.picoxr.com/document/unity/project-validation/) supported checking the following settings: <br> <br> * When using Unity6, check if the current project has the **Run In Background** option checked. If not, report an error. <br> * Check if the **MRC** checkbox is checked in the **PXR_Manager (Script)** panel. If not, report an error. <br> * Verify if the **Display Refresh Rates** parameter is set to **Default**. If not, report an error. <br> * When using Vulkan, check if the **Optimize Buffer Discards** option is checked. If not, report an error. | |
10 | | -| | [PICO Building Blocks](https://developer.picoxr.com/document/unity/pico-building-blocks) supported setting up the following: <br> <br> * Spatial Audio: free field <br> * Spatial Audio: ambisonics | |
11 | | -| Rendering | Added the `UPxr_SetSuperResolutionOrSharpening` API for dynamically enabling and disabling the [Super Resolution](https://developer.picoxr.com/document/unity/super-resolution) and [Sharpening](https://developer.picoxr.com/document/unity/sharpening) functionalities. | |
12 | | -| Sense Pack | Added the following APIs for getting the progress of uploading and downloading shared spatial anchors: <br> <br> * `UploadSpatialAnchorWithProgressAsync`: Upload spatial anchors and get the upload progress. <br> * `DownloadSharedSpatialAnchorWithProgressAsync`: Download shared spatial anchors and get the download progress. | |
13 | | -| SecureMR | Added [SecureMR](https://developer.picoxr.com/document/unity/securemr-overview) capabilities, which enables secure, AI-powered mixed reality use cases while maintaining rigorous protection of user data and privacy. | |
14 | | -| Enterprise services | Added the following APIs: <br> <br> * `SetDeviceOwner`: Sets an app as the device owner app. <br> * `GetDeviceOwner`: Gets the device owner app. <br> * `SetBrowserHomePage`: Sets a home page for the browser. <br> * `GetBrowserHomePage`: Gets the home page of the browser. <br> * `SetMotionTrackerAutoStart`: Sets the capability for the PICO Motion Tracker to automatically power on when plugged in. <br> * `AllowWifiAutoJoin`: Enables the device to automatically join WiFi. <br> * `GetLargeSpaceBoundsInfoWithType`: Gets the bound information of the large space. | |
15 | | -Below are the changes to APIs: |
16 | | -| **Class** | **API** | **What's changed** | |
17 | | -| --- | --- | --- | |
18 | | -| [PXR_Boundary](https://developer.picoxr.com/reference/unity/client-api/PXR_Boundary) | GetDimensions | Currently, only supported to be called at the StageLevel. | |
19 | | -| | GetSeeThroughTrackingState | Deprecated. | |
20 | | -| | UseGlobalPose | Deprecated. | |
21 | | -| [PXR_FoveationRendering](https://developer.picoxr.com/reference/unity/client-api/PXR_FoveationRendering/) | SetFoveationParameters | Deprecated. | |
22 | | -| [PXR_HandTracking](https://developer.picoxr.com/reference/unity/client-api/PXR_HandTracking/) | GetSettingState | Deprecated. | |
23 | | -| [PXR_Input](https://developer.picoxr.com/reference/unity/client-api/PXR_Input/) | GetDominantHand | Deprecated. | |
24 | | -| | SetDominantHand | Deprecated. | |
25 | | -| | SetControllerVibration | Deprecated. | |
26 | | -| | SetControllerVibrationEvent | Deprecated. | |
27 | | -| | StopControllerVCMotor | Deprecated. | |
28 | | -| | StartControllerVCMotor | Deprecated. | |
29 | | -| | SetControllerAmp | Deprecated. | |
30 | | -| | StartVibrateBySharem | Deprecated. | |
31 | | -| | SaveVibrateByCache | Deprecated. | |
32 | | -| | StartVibrateByCache | Deprecated. | |
33 | | -| | ClearVibrateByCache | Deprecated. | |
34 | | -| | StartVibrateByPHF | Deprecated. | |
35 | | -| | PauseVibrate | Deprecated. | |
36 | | -| | ResumeVibrate | Deprecated. | |
37 | | -| | UpdateVibrateParams | Deprecated. | |
38 | | -| | GetBodyTrackingPose | Deprecated. | |
39 | | -| | GetMotionTrackerConnectStateWithID | Deprecated. | |
40 | | -| | GetMotionTrackerBattery | Deprecated. | |
41 | | -| | GetMotionTrackerCalibState | Deprecated. | |
42 | | -| | SetBodyTrackingMode | Deprecated. | |
43 | | -| | SetBodyTrackingBoneLength | Deprecated. | |
44 | | -| | ResetController | Deprecated. | |
45 | | -| | SetArmModelParameters | Deprecated. | |
46 | | -| | CreateHapticStream | Deprecated. | |
47 | | -| | WriteHapticStream | Deprecated. | |
48 | | -| | SetHapticStreamSpeed | Deprecated. | |
49 | | -| | GetHapticStreamSpeed | Deprecated. | |
50 | | -| | GetHapticStreamCurrentFrameSequence | Deprecated. | |
51 | | -| | StartHapticStream | Deprecated. | |
52 | | -| | StopHapticStream | Deprecated. | |
53 | | -| | RemoveHapticStream | Deprecated. | |
54 | | -| | AnalysisHapticStreamPHF | Deprecated. | |
55 | | -| [PXR_MotionTracking](https://developer.picoxr.com/reference/unity/client-api/PXR_MotionTracking/) | WantEyeTrackingService | Deprecated. | |
56 | | -| | WantFaceTrackingService | Deprecated. | |
57 | | -| | GetFaceTrackingSupported | Deprecated. | |
58 | | -| | StartFaceTracking | Deprecated. | |
59 | | -| | StopFaceTracking | Deprecated. | |
60 | | -| | GetFaceTrackingState | Deprecated. | |
61 | | -| | GetFaceTrackingData | Deprecated. | |
62 | | -| | BodyTrackingAbnormalCalibrationData | Deprecated. Please use `GetBodyTrackingState` instead. | |
63 | | -| | BodyTrackingStateError | Deprecated. Please use `GetBodyTrackingState` instead. | |
64 | | -| | BodyTrackingAction | Deprecated. | |
65 | | -| | RequestMotionTrackerCompleteAction | New callback event. | |
66 | | -| | MotionTrackerConnectionAction | New callback event. | |
67 | | -| | MotionTrackerPowerKeyAction | New callback event. | |
68 | | -| | MotionTrackerNumberOfConnections | Deprecated. You can use `MotionTrackerConnectionAction` to be notified when the connection state of PICO Motion Tracker changes. | |
69 | | -| | MotionTrackerBatteryLevel | Deprecated. You can use `GetMotionTrackerBattery` to get the battery of a PICO Motion Tracker. | |
70 | | -| | MotionTrackerKeyAction | Deprecated. You can use `MotionTrackerPowerKeyAction` to receive events for the Power key of PICO Motion Trackers. | |
71 | | -| | MotionTrackingModeChangedAction | Deprecated. | |
72 | | -| | CheckMotionTrackerNumber | Newly added. | |
73 | | -| | GetMotionTrackerLocation | Newly added. | |
74 | | -| | GetMotionTrackerBattery | Newly added. | |
75 | | -| | GetMotionTrackerConnectStateWithSN | Not supported. You can use `MotionTrackerConnectionAction` to be notified when the connection state of PICO Motion Tracker changes. | |
76 | | -| | GetMotionTrackerDeviceType | Deprecated. | |
77 | | -| | CheckMotionTrackerModeAndNumber | Deprecated. Please use `CheckMotionTrackerNumber` instead. <br> | |
78 | | -| | GetMotionTrackerMode | Deprecated. | |
79 | | -| | GetMotionTrackerLocations | Deprecated. Please use `GetMotionTrackerLocation` instead. | |
80 | | -| | ExpandDeviceConnectionAction | New callback event. | |
81 | | -| | ExpandDeviceBatteryAction | New callback event. | |
82 | | -| | ExtDevConnectAction | Deprecated. Please use `ExpandDeviceConnectionAction` instead. | |
83 | | -| | ExtDevBatteryAction | Deprecated. Please use `ExtDevBatteryAction` instead. | |
84 | | -| | GetExtDevTrackerConnectState | Deprecated. You can use `ExpandDeviceConnectionAction` to get notified when the state of the connection between the PICO Motion Tracker and an external device changes. | |
85 | | -| | SetExpandDeviceVibrate | Newly added. | |
86 | | -| | GetExpandDevice | Newly added. | |
87 | | -| | SetExpandDeviceCustomData | Newly added. | |
88 | | -| | GetExpandDeviceCustomData | Newly added. | |
89 | | -| | GetExpandDeviceBattery | Newly added. | |
90 | | -| | SetExtDevTrackerMotorVibrate | Deprecated. Please use `SetExpandDeviceVibrate` instead. | |
91 | | -| | SetExtDevTrackerByPassData | Deprecated. Please use `SetExpandDeviceCustomData` instead. | |
92 | | -| | GetExtDevTrackerByPassData | Deprecated. Please use `GetExpandDeviceCustomData` instead. | |
93 | | -| | GetExtDevTrackerBattery | Deprecated. Please use `GetExpandDeviceBattery` instead. | |
94 | | -| | GetExtDevTrackerKeyData | Not supported. | |
95 | | -| [PXR_System](https://developer.picoxr.com/reference/unity/client-api/PXR_System/) | SetExtraLatencyMode | Not supported. | |
96 | | -| | EnableFaceTracking | Not supported. | |
97 | | -| | EnableLipSync | Not supported. | |
98 | | -| | GetFaceTrackingData | Not supported. | |
99 | | -| | SetEyeFOV | Not supported. | |
100 | | -| | SetFaceTrackingStatus | Not supported. | |
101 | | -| | SetCommonBrightness | Not supported. | |
102 | | -| | GetCommonBrightness | Not supported. | |
103 | | -| | GetScreenBrightnessLevel | Not supported. | |
104 | | -| | SetScreenBrightnessLevel | Not supported. | |
105 | | -| | *GetDisplayFrequenciesAvailable* | Newly added. You can use it to get the available display refresh rates. | |
106 | | -| | Action<int> SessionStateChanged; | Modified to the enumeration type Action<XrSessionState> SessionStateChanged. | |
| 10 | +| General | Supported the Unity OpenXR Plugin, and you can use this plugin to integrate XR functionalities into your app. For more information, refer to [Add support for the Unity OpenXR Plugin](/document/unity/support-for-the-unity-openxr-plugin). | |
| 11 | +| PICO Building Blocks | Added the following blocks: <br> <br> * PICO Spatial Anchor Sample <br> * PICO Spatial Mesh <br> * PICO Scene Capture <br> * PICO Composition Layer Overlay <br> * PICO Composition Layer Underlay <br> <br> For more information, refer to [PICO Building Blocks](/document/unitypico-building-blocks). | |
| 12 | +| | Compatible with the Unity OpenXR Plugin. | |
| 13 | +| Enterprise services | Added the following APIs: <br> <br> * `GetHeadTrackingStatus`: Gets the status of HMD tracking. <br> * `GetHeadPose`: Gets the pose of the HMD. <br> * `GetControllerPose`: Gets the pose of the controller. <br> * `GetSwiftPose`: Gets the pose of a motion tracker. <br> * `GetSwiftTrackerDevices`: Gets the information of motion trackers. <br> * `GetHeadIMUData`: Gets the IMU data of the HMD. <br> * `GetControllerIMUData`: Gets the IMU data of the controller. <br> * `GetSwiftIMUData`: Gets the IMU data of a motion tracker. <br> * `StartSwiftTrackerPairing`: Starts pairing motion tracker(s). <br> * `UnBondSwiftTracker`: Unbonds motion tracker(s). <br> * `ResetTracking`: Resets tracking. <br> * `SetFenceColor`: Sets the color of the fence. <br> * `GetFenceColor`: Gets the color of the fence. <br> * `SetUsbTetheringStaticIP`: Sets the static IP for USB tethering. <br> * `GetUsbTetheringStaticIPLocal`: Gets the local static IP for USB tethering. <br> * `GetUsbTetheringStaticIPClient`: Gets the client static IP for USB tethering. <br> * `SetLargeSpaceMapScale`: Sets the scale of the large-space map. <br> * `GetPredictedMainSensorState2`: Gets the predicted pose and status of the main sensor when the VST image is being displayed. <br> * `UseGlobalPose`: Uses the global pose for HMD and controller tracking. <br> * `ConvertPoseCoordinate`: Converts the coordinate of a pose. | |
| 14 | +| Developer Tools | Added the PICO Debugger, which is a debugging tool that allows you not only to view logs and scene information, but also to use its built-in tools to optimize your application in a more targeted way. For more information, refer to "[PICO Debugger](/document/unity/pico-debugger)". | |
| 15 | +**Optimize** |
| 16 | +| **Module** | **Description** | |
| 17 | +| --- | --- | |
| 18 | +| Rendering | Optimized the "Use Premultiplied Alpha" parameter used for configuring composition layers: <br> <br> * Enabled the premultiplied alpha effect for content, which multiplies the RGB color channels by the alpha value `(R×A, G×A, B×A)`. <br> * Improved the rendering performance of transparent elements, such as UI, particles, and more. <br> * Fixed visual defects such as color fringing at the edges of semi-transparent objects. <br> * Supported the specification for OpenXR and GPU hybrid rendering. | |
| 19 | +**Change** |
| 20 | +| **Module** | **Description** | |
| 21 | +| --- | --- | |
| 22 | +| Rendering | Renamed the PXR_Over Lay component used for configuring composition layer parameters to PXR_Composition Layer. | |
107 | 23 |
|
0 commit comments