Difference between revisions of "Android/Guide"

Latest revision as of 10:47, 10 January 2024

Check out our new user documentation!

We have a user documentation portal at docs.scummvm.org. It covers all aspects of using ScummVM, including how to install ScummVM on a variety of platforms, how to add and play games, and how to tweak settings for optimal game play.

This is a quick-start guide for the Android Market version of ScummVM.

Getting started

You can download ScummVM from the Android Market. ScummVM does not come with any games. Read the section 'Getting the games' below for information on how to get them. You must install the ScummVM application and copy the game data files for the game you want to play onto your phone.

Getting the games

ScummVM supports a variety of classic adventure games. You can find information about compatible games on our website.

You can download some free games from our website, such as the popular adventure games 'Beneath a Steel Sky' and 'Flight of the Amazon Queen'. You can buy other supported adventure games from various places, for example gog.com. See our page on where to get the games for more details.

Note that asking for, offering or asking for help with illegally downloaded copies of games will not be tolerated. Please buy a copy of the games you want to play.

Current known issues

Some devices display a black screen at startup for several seconds (or longer) while loading assets.
Sony Xperia devices with 'floating touch' have input problems (the 'floating touch' hover events move the mouse cursor).
Some games fail with an unsupported color mode error.
ScummVM doesn't always resume properly after being backgrounded.

Input Controls

Touchscreen

The touchscreen can be used in two modes: direct mode and touchpad mode. The default mode is touchpad mode.

When in direct mode, the mouse cursor moves to the touched point on screen. In touchpad mode, the mouse cursor is independent of the touched point, it is moved relative to its current position - like on a touchpad.

The Android version of ScummVM doesn't have an input configuration dialogue yet, but as a temporary workaround:

Direct mode can be enabled/disabled using the "Mixed AdLib/MIDI mode" checkbox on the MIDI tab in ScummVM's main options dialogue. Restart ScummVM after changing it.

Tap + movement: Mouse movement
Tap without movement: Left mouse button click
Tap held for >0.5s without movement: Right mouse button click
Tap held for >1s without movement: Middle mouse button click
Double Tap + movement: Drag and drop

On devices supporting multitouch:

Hold down one finger, tap with second: Right mouse button click
Hold down two fingers, tap with third: Middle mouse button click

5-Way navigation control / DPAD

DPAD up/down/left/right: Mouse movement
DPAD center: Left mouse button

Trackball

Movement: Mouse movement
Click: Left mouse button

System keys

Back button: Escape
Menu button: ScummVM menu
Menu button held for 0.5s: Toggle virtual keyboard
Camera or Search button: Right mouse button click

Graphical settings

The 'Fullscreen' setting controls whether your games are stretched to cover the whole screen, or whether their aspect ratio is preserved.

The 'Graphics Mode' can be set to 'Linear filtering' if you'd like smoother scaled graphics.

More information

There is an (incomplete) User Manual available on this wiki.

Saved games are stored in the 'ScummVM' directory on your SD card, if one is available. If an SD card isn't available, then saves will be written to the internal application data. Android deletes all those files when you uninstall ScummVM! Please make a copy before you do so, if you want to keep your games.

Finally, you can donate to the ScummVM project via SourceForge.net.

Visit the ScummVM website if you have any more questions, or ask on our Android ScummVM forums.

@@ Line 1: / Line 1: @@
-<!-- this page should be viewable and wrappable in small-screen browsers on Android! -->__NOTOC__
+<!-- this page should be viewable and wrappable in small-screen browsers on Android! -->
+{{DISPLAYTITLE:[Deprecated] Android/Guide}}
+{| border="0" cellpadding="1" cellspacing="2" style="margin-left:5em; background:#FF9999; width:80%"
+|- align="center"
+|'''Check out our new user documentation!'''
+|- style="margin-left:1em; background:#ffffff;"
+|- style="background:#ffffff"
+|We have a user documentation portal at [https://docs.scummvm.org docs.scummvm.org]. It covers all aspects of using ScummVM, including how to install ScummVM on a variety of platforms, how to add and play games, and how to tweak settings for optimal game play.
+|}__NOEDITSECTION__ __NOTOC__
 This is a quick-start guide for the Android Market version of ScummVM.
 == Getting started ==
-You can download ScummVM from the Android Market. '''ScummVM does not come with any games.''' Read the section 'Getting the games' below for information on how to get them.
+You can download ScummVM from the Android Market. '''ScummVM does not come with any games.''' Read the section 'Getting the games' below for information on how to get them. You must install the ScummVM application '''and''' copy the game data files for the game you want to play onto your phone.
-You must install the ScummVM application, copy the game data files for the game you want to play onto your phone, '''and''' install the ScummVM plugin which supports that game. We have a [[Engines|list of supported games]]
+== Getting the games ==
-together with the plugins they need (in the 'engine' column).
+ScummVM supports a variety of classic adventure games. You can find [https://www.scummvm.org/compatibility/ information about compatible games] on our website.
-== Getting the games ==
+You can [https://www.scummvm.org/downloads/#extras download some free games] from our website, such as the popular adventure games 'Beneath a Steel Sky' and
-ScummVM supports a variety of classic adventure games. You can find [http://scummvm.org/compatibility/ information about compatible games] on our website.
+'Flight of the Amazon Queen'. You can buy other supported adventure games from various places, for example [{{GOGLink|}} gog.com]. See our page on [[Where to get the games|where to get the games]] for more details.
-You can [http://scummvm.org/downloads/#extras download some free games] from our website, such as the popular adventure games 'Beneath a Steel Sky' (which you need ScummVM and the ScummVM plugin 'sky' to play) and
+Note that asking for, offering or asking for help with illegally downloaded copies of games will not be tolerated. Please buy a copy of the games you want to play.
-'Flight of the Amazon Queen' (which you need ScummVM and the ScummVM plugin 'queen' to play).
-You can buy other supported adventure games from various places, for example [http://www.gog.com/en/frontpage/?pp=22d200f8670dbdb3e253a90eee5098477c95c23d gog.com]. See our page on [[Where to get the games]] for more details.
+== Current known issues ==
-Note that asking for, offering or asking for help with illegally downloaded copies of games will not be tolerated. Please buy a copy of the games you want to play.
+* Some devices display a black screen at startup for several seconds (or longer) while loading assets.
+* Sony Xperia devices with 'floating touch' have input problems (the 'floating touch' hover events move the mouse cursor).
+* Some games fail with an unsupported color mode error.
+* ScummVM doesn't always resume properly after being backgrounded.
 == Input Controls ==
@@ Line 29: / Line 40: @@
 is moved relative to its current position - like on a touchpad.
-The Android version of ScummVM doesn't have an input configuration dialog yet,
+The Android version of ScummVM doesn't have an input configuration dialogue yet,
-but as a temporary workaround, touchpad mode can be toggled with the "Mixed AdLib/MIDI mode"
+but as a temporary workaround:
-checkbox on the MIDI tab in ScummVM's main options dialog. Restart ScummVM after changing it.
+Direct mode can be enabled/disabled using the "Mixed AdLib/MIDI mode"
+checkbox on the MIDI tab in ScummVM's main options dialogue. Restart ScummVM after changing it.
 Tap + movement: Mouse movement<br>
@@ Line 41: / Line 54: @@
 On devices supporting multitouch:
-Two finger tap: Right mouse button click<br>
+Hold down one finger, tap with second: Right mouse button click<br>
-Three finger tap: Middle mouse button click
+Hold down two fingers, tap with third: Middle mouse button click
 === 5-Way navigation control / DPAD ===
@@ Line 63: / Line 76: @@
 == Graphical settings ==
-The 'Fullscreen' settting controls whether your games are stretched to cover the whole screen, or whether their aspect ratio is preserved.
+The 'Fullscreen' setting controls whether your games are stretched to cover the whole screen, or whether their aspect ratio is preserved.
 The 'Graphics Mode' can be set to 'Linear filtering' if you'd like smoother scaled graphics.
@@ Line 71: / Line 84: @@
 There is an (incomplete) [[User Manual]] available on this wiki.
-Saved games are stored in the 'ScummVM' directory on your SD card, if one is available. If an SD card isn't available, then saves will be written to the internal applcation data. Android deletes all those files when you uninstall ScummVM! Please make a copy before you do so, if you want to keep your games.
+Saved games are stored in the 'ScummVM' directory on your SD card, if one is available. If an SD card isn't available, then saves will be written to the internal application data. Android deletes all those files when you uninstall ScummVM! Please make a copy before you do so, if you want to keep your games.
 Finally, you can [https://sourceforge.net/donate/index.php?group_id=37116 donate to the ScummVM project via SourceForge.net].
-Visit [http://scummvm.org the ScummVM website] if you have any more questions, or ask on our [http://forums.scummvm.org/viewforum.php?f=17" Android ScummVM forums].
+Visit [https://www.scummvm.org the ScummVM website] if you have any more questions, or ask on our [https://forums.scummvm.org/viewforum.php?f=17 Android ScummVM forums].