Difference between revisions of "Android/Guide"

From ScummVM :: Wiki
Jump to navigation Jump to search
(→‎Current known issues: fixed a syntax error. However the last two bullets are maybe no longer an issue)
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! -->__NOTOC__
 
This is a quick-start guide for the Android Market version of ScummVM.
 
This is a quick-start guide for the Android Market version of ScummVM.
 +
 +
{| border="0" cellpadding="1" cellspacing="2" style="margin-left:5em; background:#FF9999; width:80%"
 +
|- align="center"
 +
| '''NOTE'''
 +
|- style="margin-left:1em; background:#ffffff;"
 +
|- style="background:#ffffff"
 +
| Please note that information on this page may be outdated; The 'Current Known Issues', 'Input Controls', 'Graphical settings' and 'More information' sections in particular need updating.
 +
|}
  
 
== Getting started ==
 
== Getting started ==
Line 7: Line 15:
  
 
== Getting the games ==
 
== Getting the games ==
ScummVM supports a variety of classic adventure games. You can find [http://scummvm.org/compatibility/ information about compatible games] on our website.
+
ScummVM supports a variety of classic adventure games. You can find [https://www.scummvm.org/compatibility/ information about compatible games] on our website.
  
You can [http://scummvm.org/downloads/#extras download some free games] from our website, such as the popular adventure games 'Beneath a Steel Sky' and
+
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
'Flight of the Amazon Queen'. 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|where to get the games]] for more details.
+
'Flight of the Amazon Queen'. You can buy other supported adventure games from various places, for example [https://www.gog.com/en/frontpage/?pp=22d200f8670dbdb3e253a90eee5098477c95c23d gog.com]. See our page on [[Where to get the games|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.
 
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.
Line 17: Line 25:
  
 
* Some devices display a black screen at startup for several seconds (or longer) while loading assets.
 
* Some devices display a black screen at startup for several seconds (or longer) while loading assets.
* Xperia devices with 'floating touch' have input problems (the 'floating touch' hover events move the mouse cursor).
+
* 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.
 
* Some games fail with an unsupported color mode error.
 
* ScummVM doesn't always resume properly after being backgrounded.
 
* ScummVM doesn't always resume properly after being backgrounded.
Line 31: Line 39:
 
is moved relative to its current position - like on a touchpad.
 
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:
 
but as a temporary workaround:
  
 
Direct mode can be enabled/disabled using the "Mixed AdLib/MIDI mode"
 
Direct mode can be enabled/disabled using the "Mixed AdLib/MIDI mode"
checkbox on the MIDI tab in ScummVM's main options dialog. Restart ScummVM after changing it.
+
checkbox on the MIDI tab in ScummVM's main options dialogue. Restart ScummVM after changing it.
  
 
Tap + movement: Mouse movement<br>
 
Tap + movement: Mouse movement<br>
Line 67: Line 75:
 
== Graphical settings ==
 
== 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.
 
The 'Graphics Mode' can be set to 'Linear filtering' if you'd like smoother scaled graphics.
Line 75: Line 83:
 
There is an (incomplete) [[User Manual]] available on this wiki.
 
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].
 
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].

Revision as of 16:30, 28 August 2020

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

NOTE
Please note that information on this page may be outdated; The 'Current Known Issues', 'Input Controls', 'Graphical settings' and 'More information' sections in particular need updating.

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.