|
|
@@ -7,6 +7,8 @@ This project is frozen. Therefore, I provide very limited support. I will not an
|
|
|
## Installation instructions
|
|
|
Please note that this is a **development** version: bugs, empty screens and unfinished functions are *normal* here. However, as I aimed for fixing major bugs present in the latest stable version (1.0.7) before publishing the source code, the development version **may** work better than the stable one in your device. If this is the case, you are lucky!
|
|
|
|
|
|
+The development version runs on Android 4.1+. Android versions supported by all other releases available for download are stated in their description.
|
|
|
+
|
|
|
### With Android Studio
|
|
|
If you are familiar with Android programming and want to work with the source code, this is the quickest and recommended method. If not, see "Pre-built releases". The instructions below apply to Android Studio 3.0.1, but they should work flawlessly in other versions as well (minor changes might be required, please refer to the manual or online resources for your version of the IDE if necessary).
|
|
|
|
|
|
@@ -23,7 +25,73 @@ If you are familiar with Android programming and want to work with the source co
|
|
|
There are also pre-built releases which can be installed directly on Android devices without compiling the source code. They are available as APK files in "Releases". Your device must allow installing applications from unknown sources: you can change this behaviour in Android settings.
|
|
|
|
|
|
## How to use
|
|
|
-(under construction)
|
|
|
+The GUI is designed to be as easy-to-use and accessible as possible. To begin, tap a green microphone button at the bottom of the screen: when it turns red, say a command. A system speech recognition service (usually Google) processes your voice and returns the text which in turn is interpreted by the application. Alternatively, enter a command manually (using a big text box next to the microphone button) and press ENTER or tap the microphone button.
|
|
|
+
|
|
|
+If you want to access settings, tap the gearwheel icon in the bottom-left corner and select "Settings" (in Polish: "Ustawienia").
|
|
|
+
|
|
|
+As stated in the introduction, only Polish is supported at the moment.
|
|
|
+
|
|
|
+This is the list of activities Polassis can/could do (all examples in Polish):
|
|
|
+* Saying a specified phrase (e.g. "powiedz ja mam kota")
|
|
|
+* Reading the last received SMS (e.g. "przeczytaj ostatniego SMS-a")
|
|
|
+* Determining the last incoming call (e.g. "kto do mnie ostatnio dzwonił")
|
|
|
+* Determining the last outcoming call (e.g. "do kogo dzwoniłem")
|
|
|
+* Determining the last call overall (e.g. "ostatnie połączenie")
|
|
|
+* Writing an e-mail message (e.g. "wyślij e-maila")
|
|
|
+* Notes:
|
|
|
+ * Adding (e.g. "stwórz notatkę")
|
|
|
+ * Editing (e.g. 'zmień notatkę "Test"')
|
|
|
+ * Deleting (e.g. 'usuń notatkę "Test"')
|
|
|
+ * Reading (e.g. 'czytaj notatkę "Lista zakupów"')
|
|
|
+ * Showing the list of notes (e.g. "pokaż wszystkie notatki")
|
|
|
+* Writing an SMS (e.g. "napisz SMS-a do Jarka")
|
|
|
+* Taking a photo (e.g. "wykonaj zdjęcie")
|
|
|
+* Obtaining a weather forecast (e.g. "jaka pogoda za tydzień Berlin") (**a Dark Sky API key is required: it is not provided in the code, see app/src/main/res/values/constants.xml**)
|
|
|
+* Timer:
|
|
|
+ * Setting (e.g. odmierz 3 godziny 30 minut")
|
|
|
+ * Pausing/Resuming (e.g. "zatrzymaj minutnik", "wznów minutnik")
|
|
|
+ * Checking the time left (e.g. "ile jeszcze mam czasu")
|
|
|
+* Calling (e.g. "chcę zadzwonić pod numer 123456")
|
|
|
+* Doing mathematical calculations (e.g. "siedem do kwadratu przemnożone przez cztery podzielić na sześć")
|
|
|
+* Determining the day of week on a specified date (e.g. "który to był 3 stycznia 2015 roku")
|
|
|
+* Controlling a music player:
|
|
|
+ * Pausing/Resuming (e.g. "wznów odtwarzanie", "pauza")
|
|
|
+ * Repeating (e.g. "odtwórz jeszcze raz")
|
|
|
+ * Next track (e.g. "kolejna piosenka")
|
|
|
+ * Previous track (e.g. "wróć do poprzedniej muzyki")
|
|
|
+* Playing music on Spotify (e.g. "odtwórz Too Many Broken Hearts") (**not implemented**)
|
|
|
+* Turning on/off a torch (e.g. "włącz latarkę", "nie chcę latarki")
|
|
|
+* Triggering Wi-Fi/Bluetooth (e.g. "włącz Wi-Fi", "włącz Bluetooth", "możesz wyłączyć Wi-Fi", "wyłącz Bluetooth")
|
|
|
+* Turning on the silent mode (e.g. "wycisz telefon")
|
|
|
+* Turning off the silent mode (e.g. "wyłącz tryb cichy")
|
|
|
+* Opening a webpage (e.g. "otwórz google.com")
|
|
|
+* Starting an application (e.g. "uruchom Facebook")
|
|
|
+* Setting a sat-nav (e.g. "jak dojechać do Warszawy, al. Ujazdowskie 1")
|
|
|
+* Determining your location (e.g. "gdzie jestem")
|
|
|
+* Determining the location of a particular place on a map (e.g. "gdzie znajduje się Madryt")
|
|
|
+* Obtaining information from Wikipedia (e.g. "kto to jest Justyna Kowalczyk")
|
|
|
+* Searching on the Internet (e.g. "szukaj inkwizycja")
|
|
|
+* Determining the current battery level (e.g. "ile mam baterii")
|
|
|
+* Alarms:
|
|
|
+ * Setting (e.g. "ustaw budzik na 7:30")
|
|
|
+ * Deleting (e.g. "nie chcę alarmu o 22:33")
|
|
|
+* Setting the default number for a particular contact that Polassis should always choose (e.g. "ustaw domyślny numer dla Jarka")
|
|
|
+* Saying the current time (e.g. "która godzina")
|
|
|
+* Saying the current day of week (e.g. "jaki mamy dzień tygodnia")
|
|
|
+* Saying the current date (e.g. "którego mamy dzisiaj")
|
|
|
+* Setting reminders (e.g. "przypomnij mi")
|
|
|
+* Rebooting the device (e.g. "zrestartuj telefon") (**root required**)
|
|
|
+* Turning off the device (e.g. "wyłącz telefon") (**root required**)
|
|
|
+* Turning off the assistant itself (e.g. "zamknij się")
|
|
|
+* Dictating to the clipboard (e.g. "podyktuj do schowka")
|
|
|
+* Presenting the possibilities of Polassis (**not implemented**)
|
|
|
+
|
|
|
+### Troubleshooting
|
|
|
+* If the microphone button turns grey and is stuck in this state:
|
|
|
+ * Check whether speech recognition is installed and set up properly in your device. You might have to grant the speech recognition service an audio recording permission if you use Android 6.0+.
|
|
|
+ * Experimenting with Polassis settings is worthwhile (e.g. triggering the option "Wymusz. silnika Google" which is responsible for forcing using the Google speech-to-text engine)
|
|
|
+ * If you use text-to-speech, check whether a TTS service is installed and set up properly in your device.
|
|
|
+ * If you use Android 6.0+, check what permissions Polassis has been granted in your device.
|
|
|
|
|
|
## Language
|
|
|
(under construction)
|
Maksymilian Graczyk