-
Notifications
You must be signed in to change notification settings - Fork 87
Kiosk Mode
Kiosk mode is a configuration of your temi skill that allows it to take over the home screen application and instead of the default temi home screen.
In the temi Settings -> Home Screen -> Application, you can set any app as home screen application. But only the app who declares to be kiosk app in the manifest and actually selected as home screen app can be granted with special permissions, including overriding voice flow, restart the system, etc.
Return | Method | Description |
---|---|---|
void | requestToBeKioskApp() | Request to be the currently selected Kiosk skill |
boolean | isSelectedKioskApp() | Check whether the skill is the currently selected Kiosk skill |
void | setKioskModeOn(boolean on, HomeScreenMode mode) | Turn on(off) Kiosk mdoe |
boolean | isKioskModeOn | Check is Kiosk mode on |
To configure the skill as a kiosk skill you must take the following steps:
-
Open the
AndroidManifest.xml
. -
In the application tag paste the following piece of code:
<!-- Ignore this if it has been added --> <meta-data android:name="com.robotemi.sdk.metadata.SKILL" android:value="@string/app_name" /> <meta-data android:name="com.robotemi.sdk.metadata.KIOSK" android:value="TRUE" />
-
Compile and run the skill.
-
Even though the skill is visible now it is still not set as your temi's kiosk skill, to do so navigate to the settings menu. Now that you have a kiosk skill running you should see a new option in the settings called Kiosk Mode. Until the skill is set by launcher to be the default skill its' status will be OFF.
-
Click on the kiosk mode option and open the Kiosk Mode page. Turn on the kiosk mode from the top right corner.
-
Select your skill from the list of skills available for kiosk mode configuration. In the case where there is only one of those, it will automatically be selected for you when the mode is turned on.
Using this method to dynamically apply to become the currently selected Kiosk skill. Similar to requesting permission, the system will pop up a dialog box after the method is called. After user clicks the "Allow" button, your skill becomes the currently selected Kiosk skill.
-
Prototype
void requestToBeKioskApp();
-
Required permissions
None.
-
Support from
0.10.70
Check wheather your skill is the currently selected Kiosk skill.
-
Return
Type Description boolean true(false) means your skill is(is not) currently selected Kiosk skill -
Prototype
boolean isSelectedKioskApp();
-
Required permissions
None.
-
Support from
0.10.70
Use this method to enable or disable kiosk mode. You can also enable or disable kiosk mode in Settings > Apps > Kiosk. If the incoming parameter is true
, it will be the same as the processing logic of requestToBeKioskApp() and dynamically apply to become the currently selected Kiosk skill.
-
Parameters
Parameter Type Description on boolean true(false) to enable(disable) kiosk mode mode HomeScreenMode Add in 134 version, when turn off kiosk mode, can assisgn a mode to return to -
Prototype
void setKioskModeOn(boolean on, HomeScreenMode mode);
-
Required permissions
Settings, Kiosk
-
Support from
0.10.77
Check if kiosk mode is eanbled.
-
Return
Type Description boolean true(false) means kiosk mode is enabled(disabled) -
Prototype
boolean isKioskModeOn();
-
Required permissions
None.
-
Support from
0.10.77