In this article
1: Overview
Secondary Screen Support allows interviewers to display images or videos on a separate Android device (such as a phone or tablet) handed to the participant. This setup lets the interviewer remain in control of the primary device while collecting feedback, enabling them to observe and record without sharing their main interviewing screen.
2: Requirements
To use Secondary Screen Support, the following conditions must be met:
Both Primary and Secondary device need to be Android devices (as the app is using an Android-specific method to connect)
-
Wi-Fi must be On and Location enabled on both devices.
Note: A Wi-Fi network is not required. The feature uses Wi-Fi Direct for peer-to-peer communication.
Only images or videos can be displayed, and these must be stored in the File Library to ensure offline availability.
-
Both devices must have the CAPI app installed and the same survey assigned.
Tip: You can log in using the same interviewer account on both devices to quickly assign the same survey.
3: Survey Design
Use JavaScript to call the display functions within your survey. The following methods are available:
CapiApp.ShowImage(FileLibraryPath)CapiApp.ShowVideo(FileLibraryPath)
You can trigger these functions using an HTML button inside a question. For example: html Copy
<button onclick="CapiApp.ShowImage('/isa/BDJPFRDMEYBPBKLVADAYFQCDAVIOEQJR/capicommon/map.png')">Show Image</button>
When the button is tapped, the selected image or video is displayed immediately on the participant’s device via a webview.
4: Learn More
For setup instructions and a step-by-step walkthrough, see Using a Second Screen.