Package edu.tufts.hrilab.temiv3
Interface TemiV3Interface
- All Known Implementing Classes:
MockTemiV3Component
public interface TemiV3Interface
-
Method Summary
Modifier and TypeMethodDescriptionvoid
backupLocations
(Symbol collectionName) void
Linked to Language "charge"
Behavior which is automatically enacted upon battery reaching a certain percent threshold.void
checkInKiosk
(Symbol location) void
returns temi tablet to main screenvoid
signals videoDone lock allowingplayVideo(edu.tufts.hrilab.fol.Symbol)
to end and clears the screenconvertPredToReadable
(String predString) void
deleteLocation
(Symbol location) deletes location with label @locationvoid
deleteLocationBackup
(Symbol collectionName) void
void
void
void
void
void
void
Linked to language "display" or "display message" Navigates to display fragment with supplied message, not blockingvoid
zno displays alert signalling that new tasks cannot be submitted while zno is chargingvoid
void
void
void
void
void
void
void
void
sets acknowledged to truevoid
void
void
void
Utility func for interrupting goToLocation in case we are currently repositioningvoid
followMe()
void
Blocking version of followMe (waits for acknowledgement)void
Duplicate function necessary for scoping between freeze and underlying paused action acknowledgementsint
int
int
Gets Temi's current x and y coordinates on the map.int
int
int
Gets the value stored in SharedPreferences with the key "escortWaitAttempts".long
Gets the value stored in SharedPreferences with the key "escortWaitDuration".for control appgetLocationNameFromReference
(Symbol locRef) boolean
Helper function to exit with correct failure predicate in case goToLocation fails due to repositioning errorsboolean
checks that location is saved then goes to that location.boolean
Goes to desired coordinates.boolean
ignoreTentativeAccept
(Predicate goalPred) void
void
void
void
boolean
boolean
knowsLocation
(Symbol location) Checks whether the temi has stored the supplied location as a known location.void
play video, blocking untilcloseVideo()
is calledboolean
relocalize
(boolean sayText) void
void
void
restoreLocations
(Symbol collectionName) void
saveLocation
(Symbol location) Stores robots current locationvoid
void
sayTextDialogueHistory
(String message) void
sayTextDialogueHistory
(String message, boolean wait) void
void
void
void
setAppointmentListEmptyMessage
(Symbol message) void
setAppointmentLoadErrorMessage
(Symbol message) void
setBatteryAbortLevel
(Symbol abortLevel) Sets the value stored in SharedPreferences with the key "chargeActionPercent".void
setBatteryChargedLevel
(Symbol chargedLevel) Sets the value stored in SharedPreferences with the key "chargeAbortPercent".void
setBatteryWarnLevel
(Symbol warnLevel) Sets the value stored in SharedPreferences with the key "chargeWarningPercent".void
setBirthdayMessage
(Symbol message) void
setBirthdayMessageRange
(Symbol range) void
setCheckInHeaderMessage
(Symbol message) void
void
void
setEarlyAppointmentMessage
(Symbol message) void
setEscortWaitAttempts
(Symbol waitAttempts) Sets the value stored in SharedPreferences with the key "escortWaitAttempts".void
setEscortWaitDuration
(Symbol waitDuration) Sets the value stored in SharedPreferences with the key "escortWaitDuration".void
setHardButtons
(boolean disabled) Disables/enables hardButtons on the temi.boolean
setKioskLocation
(Symbol location) void
setKioskTimeout
(Symbol timeout) void
setLateAppointmentMessage
(Symbol message) void
setSayTextBlocks
(boolean value) void
setSuccessfulCheckInMessage
(Symbol message) void
Calls setVolume from temi sdkvoid
show top bar on temi tabletboolean
skipsQueue
(String funcName) void
startAcknowledgeDisplay
(String message) Blocks until acknowledged is set to truevoid
startQRCodeDisplay
(String url, String header) void
Stop moving.void
updateHomeBase
(boolean overwriteMap) void
uploadMap
(boolean overwrite) Sends temi map data to firebasevoid
wait for Temi to detect a person
-
Method Details
-
goToLoc
checks that location is saved then goes to that location.- Parameters:
location
- label for location to go to
-
interruptGoToLocation
void interruptGoToLocation() -
goToPos
Goes to desired coordinates.
Used when fetch script is enacted from an unknown starting location- Parameters:
goalCoords
- coordinates to go to
-
followMe
void followMe() -
followMeBlocking
void followMeBlocking()Blocking version of followMe (waits for acknowledgement) -
interruptFollowBlocking
void interruptFollowBlocking() -
stopMoving
void stopMoving()Stop moving. Has side effect of causing goToLocationStatus and ReposeStatus to be set to ABORT. We additionally unlock the goToLoc() condition to prevent deadlock upon temi primitives failing. -
endRepositionLoop
void endRepositionLoop()Utility func for interrupting goToLocation in case we are currently repositioning -
getRepositionFailure
boolean getRepositionFailure()Helper function to exit with correct failure predicate in case goToLocation fails due to repositioning errors- Returns:
-
saveLocation
Stores robots current location- Parameters:
location
- label for current location
-
interruptSaveLocation
void interruptSaveLocation() -
backupLocations
-
restoreLocations
-
deleteLocationBackup
-
getLocationBackupCollections
-
deleteLocation
deletes location with label @location- Parameters:
location
- label for location to be deleted
-
getCurrentPosition
Gets Temi's current x and y coordinates on the map. Used in fetch script to store coordinates to return to when called from an unknown location.- Returns:
- Temi's x,y coordinates
-
knowsLocation
Checks whether the temi has stored the supplied location as a known location. Used to exit goToLocation script when appropriate with the correct failure predicate.- Parameters:
location
- location name to check against temi's known location- Returns:
- true if there exists a matching location, false otherwise
-
getKnownLocationNames
for control app- Returns:
- list of temi's known location names
-
waitForDetection
void waitForDetection()wait for Temi to detect a person -
startAcknowledgeDisplay
Blocks until acknowledged is set to true -
endAcknowledgeDisplay
void endAcknowledgeDisplay()sets acknowledged to true -
freezeTemi
void freezeTemi()Duplicate function necessary for scoping between freeze and underlying paused action acknowledgements -
endFreezeTemi
void endFreezeTemi() -
displayFreezeScreen
void displayFreezeScreen() -
endDisplayFreezeScreen
void endDisplayFreezeScreen() -
playVideo
play video, blocking untilcloseVideo()
is called -
closeVideo
void closeVideo()signals videoDone lock allowingplayVideo(edu.tufts.hrilab.fol.Symbol)
to end and clears the screen -
display
Linked to language "display" or "display message" Navigates to display fragment with supplied message, not blocking- Parameters:
message
- message to display on screen
-
clearScreen
void clearScreen()returns temi tablet to main screen -
showTopBar
void showTopBar()show top bar on temi tablet -
uploadMap
void uploadMap(boolean overwrite) Sends temi map data to firebase -
updateHomeBase
void updateHomeBase(boolean overwriteMap) -
chargeTemi
void chargeTemi()Linked to Language "charge"
Behavior which is automatically enacted upon battery reaching a certain percent threshold. Informs the user that the charge behavior is being enacted, then proceeds to navigate to home base and wait either for acknowledgement or to reach back up to a certain battery level. The associated language command "charge" will also cause dialogue to clear the current goal queue, ensuring this task is either immediately executed or first on the queue. -
displayChargingAlert
void displayChargingAlert()zno displays alert signalling that new tasks cannot be submitted while zno is charging -
setEscortWaitDuration
Sets the value stored in SharedPreferences with the key "escortWaitDuration". Used to determine the duration to wait for acknowledgement between requests within the escort script. -
setEscortWaitAttempts
Sets the value stored in SharedPreferences with the key "escortWaitAttempts". Used to determine the number of times the temi calls out the patient name and waits for acknowledgement within the escort script. -
setBatteryWarnLevel
Sets the value stored in SharedPreferences with the key "chargeWarningPercent". Used to determine battery level upon which to perform a warning sayText to indicate the temi will clear tasks to charge soon -
setBatteryAbortLevel
Sets the value stored in SharedPreferences with the key "chargeActionPercent". Used to determine battery level upon which the temi enacts its charge behavior -
setBatteryChargedLevel
Sets the value stored in SharedPreferences with the key "chargeAbortPercent". Used to determine battery level upon which the temi enacts its charge behavior -
getEscortWaitDuration
long getEscortWaitDuration()Gets the value stored in SharedPreferences with the key "escortWaitDuration". Used to determine the duration to wait for acknowledgement between requests within the escort script. -
getEscortWaitAttempts
int getEscortWaitAttempts()Gets the value stored in SharedPreferences with the key "escortWaitAttempts". Used to determine the number of times the temi calls out the patient name and waits for acknowledgement within the escort script. -
setVolume
Calls setVolume from temi sdk- Parameters:
volume
- value to set volume to
-
setHardButtons
void setHardButtons(boolean disabled) Disables/enables hardButtons on the temi. Currently only acts on the volume buttons and the main top bar, does not affect the power button- Parameters:
disabled
- true to disable the hardButtons, false to enable them
-
sayText
-
sayTextDialogueHistory
-
sayTextDialogueHistory
-
enablePrivacyMode
void enablePrivacyMode() -
disablePrivacyMode
void disablePrivacyMode() -
requestPermissions
void requestPermissions() -
restartApp
void restartApp() -
enableVoiceAck
void enableVoiceAck() -
disableVoiceAck
void disableVoiceAck() -
enableButtons
void enableButtons() -
disableButtons
void disableButtons() -
enableObstacleNotifications
void enableObstacleNotifications() -
disableObstacleNotifications
void disableObstacleNotifications() -
enableKidsMode
void enableKidsMode() -
disableKidsMode
void disableKidsMode() -
displayFace
void displayFace() -
startQRCodeDisplay
-
endQRCodeDisplay
void endQRCodeDisplay() -
getLocationNameFromReference
-
convertPredToReadable
-
setSayTextBlocks
void setSayTextBlocks(boolean value) -
sendPositionUpdate
void sendPositionUpdate() -
relocalize
boolean relocalize(boolean sayText) -
isLocalized
boolean isLocalized() -
checkInKiosk
-
interruptCheckIn
void interruptCheckIn() -
enableKioskMode
void enableKioskMode() -
disableKioskMode
void disableKioskMode() -
setKioskTimeout
-
setKioskLocation
-
setDisplayAppointmentsSince
-
getDisplayAppointmentsSince
int getDisplayAppointmentsSince() -
setAllowAppointmentsSince
-
getAllowAppointmentsSince
int getAllowAppointmentsSince() -
setLateAppointmentMessage
-
getLateAppointmentMessage
String getLateAppointmentMessage() -
setDisplayAppointmentsUntil
-
getDisplayAppointmentsUntil
int getDisplayAppointmentsUntil() -
setAllowAppointmentsUntil
-
getAllowAppointmentsUntil
int getAllowAppointmentsUntil() -
setEarlyAppointmentMessage
-
getEarlyAppointmentMessage
String getEarlyAppointmentMessage() -
setSuccessfulCheckInMessage
-
getSuccessfulCheckInMessage
String getSuccessfulCheckInMessage() -
setBirthdayMessageRange
-
getBirthdayMessageRange
int getBirthdayMessageRange() -
setBirthdayMessage
-
getBirthdayMessage
String getBirthdayMessage() -
setAppointmentLoadErrorMessage
-
getAppointmentLoadErrorMessage
String getAppointmentLoadErrorMessage() -
setAppointmentListEmptyMessage
-
getAppointmentListEmptyMessage
String getAppointmentListEmptyMessage() -
setCheckInHeaderMessage
-
getCheckInHeaderMessage
String getCheckInHeaderMessage() -
ignoreTentativeAccept
-
skipsQueue
-