Secondary Display Control via Android Presentation Class

In this blog, we will learn about Secondary Display Control via Android Presentation Class.

Well, the title line certainly deals with a lot of words that probably most of the developers are not aware of and frankly, even I was not aware of this beauty of Android until last month.

Before we start, let me just tell you a few practical use cases for what you can build after following along.

POS Hardware Machines & their Dedicated Application –> Have you seen the agents at big retail centers using POS machines?
There you can see what is being added to your cart at the same moment and the agent is processing your order.
If you peek at agent’s screen the content will be a bit(or entirely) different.
Presentation Apps –> Have you seen the applications where whole presentation(ppts, slides) are being controlled by some android device?
If you peek at the Android device screen the slides are bit different (like with notes, descriptions, etc) but on the secondary screen (like a projector ) the presentation is entirely different.

After reading this blog you will also be able to build something similar.

Before we start talking about code let’s just clear what the words in the title are.

Display

A display is referred to as a screen or area which can show the content.

As a result, an Android device can control any number of displays.

The main point to note is that the application’s code should be able to handle each display separately and these are in sync with the main display.

Main Display

This display refers to the actual screen provided by the manufacturer of the Android device.

Hence, this screen listens to all the user interactions, gestures and motions events.

As a result, this display is referred to as Main Display.

Secondary Display

This display refers to a secondary screen which is somehow (Bluetooth, wired connections, RFC) connected to your Android device.

By Default, this screen is not user interactive and hence it is called as Display and not Screen.

Presentation Class

A presentation is a special kind of dialog whose purpose is to present content on a secondary display. A Presentation is associated with the target Display at creation time and configures its context and resource configuration according to the display’s metrics.

— developer.android.com

For Simple understanding, we need to extend this class to build a view to display on our Secondary Display.

With this understanding, now you can do anything you want on Secondary Display.

Now, in this blog, we will just be making a Welcome TextView on the Secondary Display.

APPROACH :

First, create a layout file that will be displayed on the secondary Display. For simplicity, name this file secondary_display.xml
Now, we create a class that will extend the Presentation Class. Let’s name this class SecondaryDisplay.
The Presentation class object we just created will have a default constructor and override the onCreate Method.
The constructor will take Context & a display as arguments. This will be a reference to the secondary Display.
The onCreate Method is similar to the Activity’s onCreate Method.
Now to display this content, you just need to initialize the constructor of the SecondaryDisplay class and call the show() method. (just like we do for a dialog).

CODE :

File Name –> secondary_display.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".SecondaryDisplay">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:layout_margin="8dp"
        android:padding="4dp"
        android:text="Hello, Presentation Api, \nThis text will be displayed on the secondary display"
        android:textAppearance="?android:attr/textAppearanceMedium" />


</RelativeLayout>

<?xml version="1.0" encoding="utf-8"?>

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

xmlns:app="http://schemas.android.com/apk/res-auto"

android:layout_width="match_parent"

android:layout_height="match_parent"

tools:context=".SecondaryDisplay">

<TextView

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:layout_centerInParent="true"

android:layout_margin="8dp"

android:padding="4dp"

android:text="Hello, Presentation Api, \nThis text will be displayed on the secondary display"

android:textAppearance="?android:attr/textAppearanceMedium" />

</RelativeLayout>

File Name –> SecondaryDisplay.java

public class SecondaryDisplay extends Presentation {
    /**
     * Creates a new presentation that is attached to the specified display
     * using the default theme.
     *
     * @param outerContext The context of the application that is showing the presentation.
     *                     The presentation will create its own context (see {@link #getContext()}) based
     *                     on this context and information about the associated display.
     * @param display      The display to which the presentation should be attached.
     */
    public SecondaryDisplay(Context outerContext, Display display) {
        super(outerContext, display);
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.secondary_display);
    }
}

public class SecondaryDisplay extends Presentation {

/**

* Creates a new presentation that is attached to the specified display

* using the default theme.

* @param outerContext The context of the application that is showing the presentation.

* The presentation will create its own context (see {@link #getContext()}) based

* on this context and information about the associated display.

* @param display The display to which the presentation should be attached.

public SecondaryDisplay(Context outerContext, Display display) {

super(outerContext, display);

}

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.secondary_display);

}

With the help of lines below, you can set the Secondary Display Content.

Last Step:

public class  MainActivity extends AppCompatActivity{
    public DisplayManager displayManager = null;
    public Display[] presentationDisplays = null;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        displayManager =  (DisplayManager)getSystemService(Context.DISPLAY_SERVICE);
        if (displayManager!= null){
            presentationDisplays = displayManager.getDisplays(DisplayManager.DISPLAY_CATEGORY_PRESENTATION);
            if (presentationDisplays.length > 0){               
                SecondaryDisplay secondaryDisplay = new SecondaryDisplay(MainActivity.this, presentationDisplays[0]);
                secondaryDisplay.show();               
            }
        }
    }
}

public class MainActivity extends AppCompatActivity{

public DisplayManager displayManager = null;

public Display[] presentationDisplays = null;

@Override

protected void onCreate(@Nullable Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

displayManager = (DisplayManager)getSystemService(Context.DISPLAY_SERVICE);

if (displayManager!= null){

presentationDisplays = displayManager.getDisplays(DisplayManager.DISPLAY_CATEGORY_PRESENTATION);

if (presentationDisplays.length > 0){

SecondaryDisplay secondaryDisplay = new SecondaryDisplay(MainActivity.this, presentationDisplays[0]);

secondaryDisplay.show();

}

With this last change, you have completed the task.

Now, just run your application on a device with Secondary Display and see the magic.

Keep coding and Keep Sharing 🙂

References –> https://developer.android.com/reference/android/app/Presentation

https://developer.android.com/reference/android/view/Display.html

anchit 25 October 2021

. . .

27 comments

Anish Hegde Jan 13, 2020 at 2:17 pm

Is there any software solution to test the code without any multi display harware.I mean any virtual device or something?

anchit (Moderator) Jan 13, 2020 at 4:02 pm
Hello Anish,

You can easily try this option in any android device or emulators.

All you need to do is to enable the developer options.

Then in the developer options menu find the option “Simulate secondary displays”.

From the list that opens up , you can easily select the width option as per your need.

Reply

Kim Jul 23, 2020 at 2:19 pm

Good Job!
Thank you!!!
How to controll secondary display?

anchit (Moderator) Dec 29, 2020 at 12:11 am
Hello,

I am assuming that by control you want to listen to some of the events on the secondary display.

So, if that is all about majorly click listeners then you can add them as you add it to any of the views in your code in your secondary display class as well.

Though, I have not practically implemented any listeners for the secondary display.

But i guess, this should work fine.

Still, if you are looking for soemthing else, then feel free to type more over here.

Regards,
Anchit

Reply
- Sunil May 19, 2021 at 10:52 pm
  Hello Anchit,
  I tried solution suggested by you, but its not working. I want handle on click event of view. So I set click listener on button, but not executing.
  
  If you know the solution then please let me know.
  
  Thanks,
  Sunil
  
  Reply
  - anchit (Moderator) May 22, 2021 at 12:11 am
    Where is that button ?
    
    I would need access to your code and then only i can help you out.
    
    Reply

Suheel Yousuf Wani Feb 7, 2021 at 12:56 am

Hello Anish
Very well explained.
I have a query, How to send data from main activity to 2nd display, for example if we type some thing on main activity, the same should be get displayed on 2nd display

anchit (Moderator) Feb 8, 2021 at 8:45 pm
Hi,

This seems to be pretty easy.

You can either create some method in your secondary display class and update the ui accordingly.

Or

You can declare the components public and then access the same in the main activity.

Both will work.

Reply

Shejal Dekate Jun 7, 2021 at 4:20 am

Hi Anchit,
I want to have two screens for automotive AVD and transfer the information of the main screen to the secondary screen. How will this connection be made? Also, may I get your mailing information?

anchit (Moderator) Jun 7, 2021 at 11:19 am
Hi,

I personally have not worked on automotive AVD.

As per me the connection to secondary screen in AVD will depend totally on how both of the screens are connected.

If the connection is physically wired, then you can also go with the points mentioned in the article.

Regarding mailing details, please do send your query to [email protected]

Reply

Allison Sep 22, 2021 at 11:53 am

Hi, I have multiple activities in my app. I just want to hide my main display for most of the activities. Only in payments screen I want to show some data in second display. For remaining I can just show images or videos.

To do this should I call presentation in all activities? Or can I call it from base activity?

anchit (Moderator) Sep 25, 2021 at 6:01 pm

i would recommend you to call in the base activity.

when you need to change the content on the secondary display just override the activity.

Reply

Snehal Nov 26, 2021 at 12:29 pm

HI Anchit,
I want to connect android device to display screens via HDMI and content from android will shown on screen will this code worked for me?

anchit (Moderator) Nov 27, 2021 at 6:19 pm
hi snehal,
Yes, the code in the blog above should work for you.

Reply
- Snehal Nov 29, 2021 at 11:11 am
  Thank you
  
  Reply
  - anchit (Moderator) Nov 30, 2021 at 10:57 pm
    your welcome
    
    Reply

Vans Feb 8, 2022 at 9:27 pm

you are genius! I used your example, imported, thought here goes nothing, and it worked!!! Thank you so muchhhhh!!!

anchit (Moderator) Feb 9, 2022 at 1:59 pm

your welcome

Reply

Sailee Shuddhalwar Mar 31, 2022 at 12:34 pm

Hi Anchit,
I am getting this error
Unable to add window [email protected] — the specified display can not be found

while running this example on emulator.
looking forward for your help.

Sailee Shuddhalwar Apr 1, 2022 at 10:11 am
Hi Anchit
Can you please help me out, I found this example very helpful but not able to run this on emulator .
it would be great if you give me some of your suggestions.
Thanks you.

Reply
- anchit (Moderator) Apr 2, 2022 at 8:09 am
  
  Hi,
  
  For both points, please first check that the secondary display is fully simulated on your emulator.
  
  If you are able to successfully simulate the dual-screen, then the article is good enough to work like a charm.
  
  Reply
  - Govind May 20, 2022 at 12:31 pm
    I have enabled “Add secondary display” in the emulator and I can see 2 displays being launched. But not able to simulate the secondary activity on the second display, followed the above piece of code . Could you please help here?
    
    Reply
    - anchit (Moderator) Aug 7, 2022 at 11:12 pm
      I will need to have a look into the code that you are working on.
      
      Please do share the same.
      
      Reply

Avanindra Dubey Apr 11, 2022 at 4:48 pm

Hi Anchit, described in very concise way. Helped a lot.
Keep doing such things. Thanks.

anchit (Moderator) Apr 12, 2022 at 11:05 pm

Your Welcome

Reply

pravin Jun 7, 2022 at 3:34 pm

Can we capture user input/interaction? if yes please add some samples.

also my project is library based where one base project and other modules are divided into libraries. so how to handle this kind of structure?

anchit (Moderator) Aug 7, 2022 at 11:49 pm

Hi there,

Yes, we can capture user input and interaction if the secondary hardware supports it.

Sorry, I can’t share samples right now but this is possible with simple logic.

For library-based project, i would recommend adding this functionality to the base project itself so that you can use it on the go in different libraries as per the use case.

Rest all can be done as per your project’s requirement.

Reply