added attention_transfer event and get_latest_attention_transfer method

Author: ikkez

anki_vector/events.py

@@ -36,6 +36,7 @@ class Events(Enum):
     # Robot
     robot_state = "robot_state"                    #: Robot event containing changes to the robot's state.
     stimulation_info = "stimulation_info"          #: Robot event containing information about the robot's stimulation.
+    attention_transfer = "attention_transfer"      #: Robot event triggered when an attention cannot be fullfilled
     mirror_mode_disabled = "mirror_mode_disabled"  # : Robot event triggered when mirror mode (camera feed displayed on robot's face) is automatically disabled due to SDK no longer having control of the robot.
     vision_modes_auto_disabled = "vision_modes_auto_disabled"  # : Robot event triggered when all vision modes are automatically disabled due to the SDK no longer having control of the robot.
 

anki_vector/robot.py

@@ -796,6 +796,26 @@ async def get_battery_state(self) -> protocol.BatteryStateResponse:
         get_battery_state_request = protocol.BatteryStateRequest()
         return await self.conn.grpc_interface.BatteryState(get_battery_state_request)
 
+    @on_connection_thread(requires_control=False)
+    async def get_latest_attention_transfer(self) -> protocol.LatestAttentionTransferResponse:
+        """Get the reason why the latest attention transfer failed, if any
+        
+            Returns <AttentionTransfer> with the fields:
+                - reason <AttentionTransferReason>
+                - seconds_ago
+            
+            .. testcode::
+
+            import anki_vector
+            with anki_vector.Robot() as robot:
+                att_trans = robot.get_latest_attention_transfer()
+                if att_trans:
+                    print("Last attention transfer failed because of: {0}".format(att_trans.reason))
+        """
+        latest_attention_transfer = protocol.LatestAttentionTransferRequest()
+        return await self.conn.grpc_interface.GetLatestAttentionTransfer(latest_attention_transfer)
+
+
     @on_connection_thread(requires_control=False)
     async def get_version_state(self) -> protocol.VersionStateResponse:
         """Get the versioning information for Vector, including Vector's os_version and engine_build_id.