FTC RobotController(SDK) v12.0发布

FTC RobotController(SDK) v12.0发布

by 北一 张 -
Number of replies: 0

Version 12.0 (20260907-090034)

Breaking Changes

  • The new AprilTag Cluster capability breaks legacy AprilTag OpModes resulting in compile errors for software that uses AprilTagDetection objects in both Android Studio and OnBot Java.
    • Legacy AprilTag OpModes must be updated to check whether the returned AprilTag is a cluster or singleton, and cast the returned detection into the correct type to access its elements. See below:

      Old method for AprilTag processing

       for (AprilTagDetection detection : currentDetections) {
         // Do single Tag processing here  
       }
      
       

      New method for AprilTag Singleton/Cluster processing

       for (AprilTagDetection detection : currentDetections) {
         if (detection instanceof AprilTagSingleDetection) {
           AprilTagSingleDetection singleDet = (AprilTagSingleDetection) detection;
           // Do single Tag processing here  
         } else {
           AprilTagClusterDetection clusterDet = (AprilTagClusterDetection) detection;
           // Do cluster Tag processing here  
         }
       }
      
       

      For more information about how to update your OpModes to fix the breaking change see: https://ftc-docs.firstinspires.org/apriltag-clusters

    • About AprilTag clusters:

      • Clusters are co-planar groups of two or more AprilTags wherein the position of each member tag is defined relative to a common origin
      • This origin may be placed outside the bounds of the tags themselves to provide a more suitable "aiming" target
      • Clusters are resilient to partial occlusion. Full 6DOF pose can be estimated from a cluster even if only a single member tag is visible. Of course, the more tags that are visible, the better and more stable the pose estimate will be
      • All AprilTag samples have been updated to differentiate between standalone tags and clusters

Enhancements

  • Adds a tree view for robot configurations issue 1821
  • Gamepad indicators on the Driver Station are now colored orange if the respective gamepads are connected to the Android generic gamepad driver instead of the Driver Station's usermode USB driver
  • Updated AprilTag Library for BIOBUZZ. Notably, getCurrentGameTagLibrary() now returns BIOBUZZ tags.
    • In BIOBUZZ, the Origin of each cluster is located in the center of the Cell opening for easy aiming.
    • The Origin X,Y & Z Axes are now displayed by default on the preview image.
    • Unfortunately, since BIOBUZZ AprilTags move, they are not suitable for absolute Field Localization.
  • Supports OctoQuad MK2 firmware v3.1.0, which adds diagnostics parameters for the IMU and MCU uptime

Bug Fixes

  • Fixes issue 2078 where battery voltage was not updated on driver station if OpMode did not send any telemetry.