Package edu.tufts.hrilab.temiv3
Interface TemiV3Interface
- All Known Implementing Classes:
MockTemiV3Component
public interface TemiV3Interface
-
Method Summary
Modifier and TypeMethodDescriptionvoidbackupLocations(Symbol collectionName) voidLinked to Language "charge"
Behavior which is automatically enacted upon battery reaching a certain percent threshold.voidcheckInKiosk(Symbol location) voidreturns temi tablet to main screenvoidsignals videoDone lock allowingplayVideo(edu.tufts.hrilab.fol.Symbol)to end and clears the screenconvertPredToReadable(String predString) voiddeleteLocation(Symbol location) deletes location with label @locationvoiddeleteLocationBackup(Symbol collectionName) voidvoidvoidvoidvoidvoidvoidLinked to language "display" or "display message" Navigates to display fragment with supplied message, not blockingvoidzno displays alert signalling that new tasks cannot be submitted while zno is chargingvoidvoidvoidvoidvoidvoidvoidvoidvoidsets acknowledged to truevoidvoidvoidvoidUtility func for interrupting goToLocation in case we are currently repositioningvoidfollowMe()voidBlocking version of followMe (waits for acknowledgement)voidDuplicate function necessary for scoping between freeze and underlying paused action acknowledgementsintintintGets Temi's current x and y coordinates on the map.intintintGets the value stored in SharedPreferences with the key "escortWaitAttempts".longGets the value stored in SharedPreferences with the key "escortWaitDuration".for control appgetLocationNameFromReference(Symbol locRef) booleanHelper function to exit with correct failure predicate in case goToLocation fails due to repositioning errorsbooleanchecks that location is saved then goes to that location.booleanGoes to desired coordinates.booleanignoreTentativeAccept(Predicate goalPred) voidvoidvoidvoidbooleanbooleanknowsLocation(Symbol location) Checks whether the temi has stored the supplied location as a known location.voidplay video, blocking untilcloseVideo()is calledbooleanrelocalize(boolean sayText) voidvoidvoidrestoreLocations(Symbol collectionName) voidsaveLocation(Symbol location) Stores robots current locationvoidvoidsayTextDialogueHistory(String message) voidsayTextDialogueHistory(String message, boolean wait) voidvoidvoidvoidsetAppointmentListEmptyMessage(Symbol message) voidsetAppointmentLoadErrorMessage(Symbol message) voidsetBatteryAbortLevel(Symbol abortLevel) Sets the value stored in SharedPreferences with the key "chargeActionPercent".voidsetBatteryChargedLevel(Symbol chargedLevel) Sets the value stored in SharedPreferences with the key "chargeAbortPercent".voidsetBatteryWarnLevel(Symbol warnLevel) Sets the value stored in SharedPreferences with the key "chargeWarningPercent".voidsetBirthdayMessage(Symbol message) voidsetBirthdayMessageRange(Symbol range) voidsetCheckInHeaderMessage(Symbol message) voidvoidvoidsetEarlyAppointmentMessage(Symbol message) voidsetEscortWaitAttempts(Symbol waitAttempts) Sets the value stored in SharedPreferences with the key "escortWaitAttempts".voidsetEscortWaitDuration(Symbol waitDuration) Sets the value stored in SharedPreferences with the key "escortWaitDuration".voidsetHardButtons(boolean disabled) Disables/enables hardButtons on the temi.booleansetKioskLocation(Symbol location) voidsetKioskTimeout(Symbol timeout) voidsetLateAppointmentMessage(Symbol message) voidsetSayTextBlocks(boolean value) voidsetSuccessfulCheckInMessage(Symbol message) voidCalls setVolume from temi sdkvoidshow top bar on temi tabletbooleanskipsQueue(String funcName) voidstartAcknowledgeDisplay(String message) Blocks until acknowledged is set to truevoidstartQRCodeDisplay(String url, String header) voidStop moving.voidupdateHomeBase(boolean overwriteMap) voiduploadMap(boolean overwrite) Sends temi map data to firebasevoidwait 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
-