Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 4 additions & 0 deletions docs/modules/manual-testing/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@
** xref:manual-testing:local-devices/capture-network-payload-data.adoc[]
** xref:manual-testing:local-devices/use-apple-pay-in-manual-session.adoc[]

* Screen reader (accessibility)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I moved all docs related to VoiceOver under this category and added navigation items for them.

** xref:manual-testing:screen-reader/voice-over-manual-session.adoc[]
** xref:manual-testing:screen-reader/screen-reader-gestures.adoc[]

* xref:manual-testing:inject-audio.adoc[]
* xref:manual-testing:test-your-app-camera.adoc[]
* xref:manual-testing:adb-commands.adoc[]
Expand Down
13 changes: 11 additions & 2 deletions docs/modules/manual-testing/pages/device-controls.adoc
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
= Device controls
:navtitle: Device controls

Use these device controls to interact with your device during a manual test session.
Interact with your device during a manual test session using these device controls.

== Touch

To interact with your device, select *Touch*, then use *left-click* to tap and swipe the device screen.
To interact with your device, select *Touch*, then *left-click* to tap and swipe the device screen.

image:manual-testing:select-touch-context.png[width=1000,alt="Select Touch on Manual session"]

Expand Down Expand Up @@ -176,3 +176,12 @@ image:manual-testing:screenshot-context.png[width=750, alt="A manual session wit
To download your screenshots, select *Screenshots*, then choose a screenshot to download.

image:manual-testing:select-screenshot-closeup.png[width=750,alt="Select screenshots you want to download"]

== VoiceOver

Use VoiceOver on iOS devices to test app accessibility. +
To enable it in a *Manual Session*, open the *Screen Reader* menu in the left navigation bar.

image:voiceover-manual-session.png[width=750, alt="Enable VoiceOver through the Screen Reader toggle in a manual session"]

For more information, see the xref:screen-reader/voice-over-manual-session.adoc[VoiceOver guide,window=read-later].
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added link to the VoiceOver guide here so users can navigate to it.

Original file line number Diff line number Diff line change
@@ -0,0 +1,150 @@
= Screen reader gestures and keyboard shortcuts
Copy link
Collaborator

@tungmhoang tungmhoang Feb 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I changed from Title Case to Sentence case to match other docs.

:navtitle: Gestures and shortcuts

== Overview

Use these gestures to navigate and interact with devices when VoiceOver (iOS) is enabled. The gestures shown during a session automatically reflect the platform of the connected device.

During a manual session, a reference modal is available to show supported gestures and keyboard shortcuts.

[IMPORTANT]
On Windows computers, use the Windows key for keyboard shortcuts with CMD (command) key.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added this note for Windows users.


== Navigation and interaction

[cols="1,1,3", options="header"]
|===
| Action | Gesture/Key | Description

| Next
| Right arrow
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I removed the VO + part from all gesture/key because this does not apply to Kobiton manual session.
Example: you don't need to press VO + Right arrow to move to the next item. You just need to press Right arrow.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ohhh okay, I was wondering what that was there for.

| Move to the next item

| Previous
| Left arrow
| Move to the previous item

| Activate
| Space
| Activate the selected item

| Back / Close
| Esc
| Go back or close the current view

| Open item chooser
| I
| Open the item chooser

| Next option
| Up arrow
| Skip to the next option

| Previous option
| Down arrow
| Skip back to the previous option

| Home screen
| H
| Return to the home screen

| Status bar
| M
| Show the status bar

| Help
| K
| Open help or support
|===

== Rotor controls

[cols="1,1,3", options="header"]
|===
| Action | Gesture/Key | Description

| Next (Rotor)
| CMD + Right arrow
| Select next Rotor setting

| Previous (Rotor)
| CMD + Left arrow
| Select previous Rotor setting

| Increment (Rotor)
| CMD + Up arrow
| Increment Rotor value

| Decrement (Rotor)
| CMD + Down arrow
| Decrement Rotor value
|===

== System and app management

[cols="1,1,3", options="header"]
|===
| Action | Gesture/Key | Description

| Toggle MultiTask Pane
| H (x2)
| Toggle App Switcher
|===

== Reading and speech

[cols="1,1,3", options="header"]
|===
| Action | Gesture/Key | Description

| Read from top
| B
| Read all items from the top of the screen

| Read from current
| A
| Read all items starting from the current item

| Pause / Resume
| Control
| Pause or resume speech output
|===

== Text editing and focus

[cols="1,1,3", options="header"]
|===
| Action | Gesture/Key | Description

| Next text field
| Tab
| Move to the next text field

| Previous text field
| Shift + Tab
| Return to the previous text field

| Select all
| CMD + A
| Select all content

| Copy
| CMD + C
| Copy the selected content

| Cut
| CMD + X
| Cut the selected content

| Paste
| CMD + V
| Paste the copied or cut content

| Undo
| CMD + Z
| Undo the last action

| Redo
| Shift + CMD + Z
| Redo the last action
|===
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
= Test VoiceOver in manual iOS sessions
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I changed the title to start with an action to match other docs. Also updated from Title Case from Sentence case.

:navtitle: Test VoiceOver (iOS)

== Overview

Test accessibility on iOS devices during a manual session using VoiceOver.

== Prerequisites

Before using VoiceOver in a manual session, ensure the following requirements are met:

* A private iOS device that supports a Bluetooth keyboard
* The iOS device must operate in Lightning mode to support audio output during manual testing sessions.

NOTE: Audio output during VoiceOver testing is supported only on devices configured with Bluetooth keyboard access.

== Using VoiceOver During a Manual Session

When a manual session is active:

* The Screen Reader icon is selectable in the left toolbar
* Selecting the icon opens a floating Screen Reader modal

image:voiceover-manual-session.png[width=750, alt="Screenshot of the Screen Reader modal"]

From the Screen Reader modal, users can:

* Turn VoiceOver mode on or off using the toggle
* Select a gesture or command to perform the corresponding action on the device screen
* Listen to VoiceOver output while navigating and interacting with the device

For a complete list of supported gestures, see xref:screen-reader/screen-reader-gestures.adoc[VoiceOver gestures and commands,window=read-later].

Each gesture or command includes:

* A supporting description explaining its behavior
* A keyboard shortcut displayed in the modal

While VoiceOver mode is enabled:

* Other toolbar tools remain available
* The device screen can still be interacted with normally
* VoiceOver gestures supplement, rather than replace, standard interaction
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@

Learn how to test your app camera using image injection, so you can ensure end-users can take photos or scan QR codes with your app.

== Before you start
== Before you begin


Enable image injection for your app with one of these options:
Expand Down
Loading