Video View Customisation - CometChat Docs

You’re reading the legacy documentation for Calling SDK v4 (Android).Follow this page only if your app is on v4.x. If you’re using v5, see the Calling SDK v5 documentation instead.Ready to move off v4? Follow the v4 → v5 migration guide.

This section will guide you to customise the main video container.

Implementation

Once you have decided to implement Ringing or Call Session calling and followed the steps to implement them. Just few additional methods will help you quickly customize the main video container. Please make sure your callSettings is configured accordingly for Ringing or Call Session.

Main Video Container Setting

The MainVideoContainerSetting Class is the required in case you want to customise the main video view. You need to pass the Object of the MainVideoContainerSetting Class in the setMainVideoContainerSetting() method of the CallSettingsBuilder.

Setting	Description
`setMainVideoAspectRatio(String aspectRatio)`	This method is used to set the aspect ratio of main video. The default value is `CometChatCallsConstants.ASPECT_RATIO_CONTAIN` Possible Values: 1. `CometChatCallsConstants.ASPECT_RATIO_CONTAIN` 2. `CometChatCallsConstants.ASPECT_RATIO_COVER`
`setFullScreenButtonParams(String position, Boolean visibility)`	This method is used to set the position & visibility parameter of the full screen button. By default the full screen button is visible in the `CometChatCallsConstants.POSITION_BOTTOM_RIGHT` position. Possible Values for position: 1. `CometChatCallsConstants.POSITION_TOP_LEFT` 2. `CometChatCallsConstants.POSITION_TOP_RIGHT` 3. `CometChatCallsConstants.POSITION_BOTTOM_LEFT` 4. `CometChatCallsConstants.POSITION_BOTTOM_RIGHT` Possible Values for visibility: 1. `true` 2. `false`
`setNameLabelParams(String position, Boolean visibility, String backgroundColor)`	This method is used to set the position, visibility & background color of the name label. By default the name label is visible in the `CometChatCallsConstants.POSITION_BOTTOM_LEFT` position with a background-color `#333333` Possible Values for position: 1. `CometChatCallsConstants.POSITION_TOP_LEFT` 2. `CometChatCallsConstants.POSITION_TOP_RIGHT` 3. `CometChatCallsConstants.POSITION_BOTTOM_LEFT` 4. `CometChatCallsConstants.POSITION_BOTTOM_RIGHT` Possible Values for visibility: 1. `true` 2. `false`
`setZoomButtonParams(String position, Boolean visibility)`	This method is used to set the position, visibility of the zoom button. By default the zoom button is visible in the `CometChatCallsConstants.POSITION_BOTTOM_RIGHT` position. Possible Values for position: 1. `CometChatCallsConstants.POSITION_TOP_LEFT` 2. `CometChatCallsConstants.POSITION_TOP_RIGHT` 3. `CometChatCallsConstants.POSITION_BOTTOM_LEFT` 4. `CometChatCallsConstants.POSITION_BOTTOM_RIGHT` Possible Values for visibility: 1. `true` 2. `false`
`setUserListButtonParams(String position, Boolean visibility)`	This method is used to set the position, visibility of the user list button. By default the user list button is visible in the `CometChatCallsConstants.POSITION_BOTTOM_RIGHT` position. Possible Values for position: 1. `CometChatCallsConstants.POSITION_TOP_LEFT` 2. `CometChatCallsConstants.POSITION_TOP_RIGHT` 3. `CometChatCallsConstants.POSITION_BOTTOM_LEFT` 4. `CometChatCallsConstants.POSITION_BOTTOM_RIGHT` Possible Values for visibility: 1. `true` 2. `false`

Example:

Java
Kotlin

MainVideoContainerSetting videoSettings = new MainVideoContainerSetting();

videoSettings.setMainVideoAspectRatio(CometChatCallsConstants.ASPECT_RATIO_CONTAIN);
videoSettings.setFullScreenButtonParams(CometChatCallsConstants.POSITION_BOTTOM_RIGHT, true);
videoSettings.setNameLabelParams(CometChatCallsConstants.POSITION_BOTTOM_LEFT, true, "#333333");
videoSettings.setZoomButtonParams(CometChatCallsConstants.POSITION_BOTTOM_RIGHT, true);
videoSettings.setUserListButtonParams(CometChatCallsConstants.POSITION_BOTTOM_RIGHT, true);   

val videoSettings = MainVideoContainerSetting()

videoSettings.mainVideoAspectRatio = CometChatCallsConstants.ASPECT_RATIO_CONTAIN
videoSettings.setFullScreenButtonParams(CometChatCallsConstants.POSITION_BOTTOM_RIGHT, true)
videoSettings.setNameLabelParams(CometChatCallsConstants.POSITION_BOTTOM_LEFT, true, "#333333")
videoSettings.setZoomButtonParams(CometChatCallsConstants.POSITION_BOTTOM_RIGHT, true)
videoSettings.setUserListButtonParams(CometChatCallsConstants.POSITION_BOTTOM_RIGHT, true)   