Share the screen

• ZEGO Express SDK: the real-time Audio and Video Call SDK provided by ZEGOCLOUD. It can help you provide audio and video services that feature convenient access, high-definition and fluency, cross-platform communication, low latency, and high concurrency.
• Stream publishing: the process of publishing the audio and video data streams that are captured and packaged to ZEGOCLOUD real-time audio and video cloud.
• Stream playing: the process of receiving and playing audio and video data streams from ZEGOCLOUD real-time audio and video cloud.
• Room: the service provided by ZEGOCLOUD for organizing user groups and allowing users in the same room to receive and send real-time audio, video, and messages to each other.
  1. Users can publish or play streams only after logging in to a room.
  2. Users can receive notifications about changes (such as users joining or leaving a room, and audio and video stream changes) in the room where they are in.

ZegoCanvas previewCanvas = new ZegoCanvas(binding.videoView);
ZegoExpressEngine.getEngine().startPreview(previewCanvas,ZegoPublishChannel.AUX);

In general, the type of stream can be agreed upon through the construction rules of stream ID, which is suitable for most scenarios:

1. You can configure the stream ID of the camera and microphone on ZegoPublishChannel.MAIN as ${roomID}_${localUserID}_main, and configure the stream ID of screen sharing on ZegoPublishChannel.AUX as ${roomID}_${localUserID}_share.

2. When the callback on the stream added is received by the stream players, the stream type can be judged according to the stream ID rule.

3. The server callback can also judge the stream type according to the same rule.

If using stream ID to identify stream type is not suitable, you can use stream attachment information to mark stream type. See setStreamExtraInfo method for details.

In this case, publishing multiple streams is not required. You just need to replace the video source of the main channel with the screen sharing source:

1. Create a screen sharing source and configure it to ZegoPublishChannel.MAIN, like this:

ZegoExpressEngine.getEngine().setVideoSource(ZegoVideoSourceType.SCREEN_CAPTURE, ZegoPublishChannel.MAIN);
ZegoVideoConfig videoConfig = new ZegoVideoConfig(ZegoVideoConfigPreset.PRESET_720P);
ZegoExpressEngine.getEngine().setVideoConfig(videoConfig, ZegoPublishChannel.MAIN);

This way, the ZegoPublishChannel.MAIN channel will use screen sharing as the video source and use the microphone as the audio source.

2. Use ZegoPublishChannel.MAIN as the channel parameter in the following steps. Like this:

ZegoExpressEngine.getEngine().startPublishingStream(streamID, ZegoPublishChannel.MAIN);
ZegoExpressEngine.getEngine().stopPublishingStream(ZegoPublishChannel.MAIN);

1. The screen sharing function of the SDK now supports adaptive screen orientation.

• When the host is in portrait mode, the viewer will receive video in portrait resolution.
• When the host is in landscape mode, the viewer will receive video in landscape resolution.

Therefore, your app's host side does not need to do any additional processing.

If the viewer needs to identify the screen orientation based on the resolution of the received video stream and adjust the UI accordingly, you can achieve this by listening to the onPlayerVideoSizeChanged event callback.

ZegoExpressEngine.getEngine().setEventHandler(new IZegoEventHandler() {
    @Override
    public void onPlayerVideoSizeChanged(String streamID, int width, int height) {
        super.onPlayerVideoSizeChanged(streamID, width, height);
        if (width < height) {
        }else{
        }
    }
}

2. Adaptive screen orientation for the host's camera

The SDK captures the camera feed based on the portrait resolution by default, regardless of whether the host's phone is in landscape or portrait mode. In a game live streaming scenario, you may need to adjust the camera feed to landscape resolution when the host's phone is in landscape mode.

Step 1. config your Activity configuration in AndroidManifest.xml as follows:

<activity
    android:name=".LiveActivity"
    // add this line
    android:configChanges="locale|keyboardHidden|fontScale|orientation|screenSize|screenLayout|layoutDirection|density|uiMode"
    android:exported="false" />

Step 2. add a BroadcastReceiver for configuration change,and register after join room:

IntentFilter configurationChangeFilter = new IntentFilter();
configurationChangeFilter.addAction("android.intent.action.CONFIGURATION_CHANGED");
BroadcastReceiver configurationChangeReceiver = new BroadcastReceiver() {
            @Override
            public void onReceive(Context context, Intent intent) {
                ZegoOrientation orientation = ZegoOrientation.ORIENTATION_0;

                ZegoVideoConfig videoConfig = new ZegoVideoConfig(videoConfigPreset);
                ZegoVideoConfig preset540 = new ZegoVideoConfig(ZegoVideoConfigPreset.PRESET_540P);

                if (Surface.ROTATION_0 == getWindowManager().getDefaultDisplay().getRotation()) {
                    orientation = ZegoOrientation.ORIENTATION_0;
                    videoConfig.setEncodeResolution(preset540.encodeWidth, preset540.encodeHeight);

                } else if (Surface.ROTATION_180 == getWindowManager().getDefaultDisplay().getRotation()) {
                    orientation = ZegoOrientation.ORIENTATION_180;
                    videoConfig.setEncodeResolution(preset540.encodeWidth, preset540.encodeHeight);

                } else if (Surface.ROTATION_270 == getWindowManager().getDefaultDisplay().getRotation()) {
                    orientation = ZegoOrientation.ORIENTATION_270;
                    videoConfig.setEncodeResolution(preset540.encodeHeight, preset540.encodeWidth);

                } else if (Surface.ROTATION_90 == getWindowManager().getDefaultDisplay().getRotation()) {
                    orientation = ZegoOrientation.ORIENTATION_90;
                    videoConfig.setEncodeResolution(preset540.encodeHeight, preset540.encodeWidth);

                }

                ZegoExpressEngine.getEngine().setAppOrientation(orientation);
                ZegoExpressEngine.getEngine().setVideoConfig(videoConfig);
            }
        };

registerReceiver(configurationChangeReceiver, configurationChangeFilter);

Conclusion

Congratulations! Hereby you have completed the development of the screen sharing feature.

If you have any suggestions or comments, feel free to share them with us via Discord. We value your feedback.