# getVideoMatrix

Description

Obtain information about the current layout

void getVideoMatrix()

Response example

{
    "matrixType": 1,
    "mainWindowWidth": 1920,
    "mainWindowHeight": 1080,
    "selfViewMode": 2,
    "participants": [{
        "peerId": "#self:0",
        "peerDn": "Display Name 1",
        "left": 0,
        "top": 720,
        "width": 640,
        "height": 360,
        "type" : 0
    }, {
        "peerId": "user2@some.server",
        "peerDn": "Display Name 2",
        "left": 0,
        "top": 0,
        "width": 1920,
        "height": 1080,
        "type" : 0
    }],
    "externVideoSlots": [{
        "callId": "SlideShowSlot",
        "peerDn": "Display Name 3",
        "monitorDisplayName": "Generic PnP Monitor",
        "monitorIdx": 1,
        "monitorIsPrimary": false,
        "type" : 0
    }],
    "hiddenVideoSlots": ["user4@some.server", "user5@some.server"],
    "method": "getVideoMatrix",
    "requestId" : "1",
    "result": true
}

Response Parameters

Name Description
selfViewMode The self-view mode. The following options are possible:
• 1 - The self-view video is displayed over the layout
• 2 - The self-view video is within the layout
participants Video slot list
• peerId - The unique identifier (TrueConf ID) of a user who is sending the video stream. #self:0 always refers to the video slot with the TrueConf VideoSDK camera
• peerDn - User display name
• title - Title of slideshow sent by user. The field is available only for SlideShowSlot
• top - y-coordinate
• left - x-coordinate
• width - Width
• height - Height
mainWindowWidth Width of a video area for video slots
mainWindowHeight Height of a video area for video slots
matrixType Type of allocation matrix. The matrix can be the following types:
• 0 - Show only one window. If there are more windows in the list, the first one will be show
• 1 - All windows are the same size
• 2 - One window is large (in the upper left corner), other smaller windows are placed around the large one
• 3 - One large window (in the center at the top), other smaller windows are placed at the bottom
• 4 - One window is large (in the left corner), other smaller windows are placed to the right of the large one
• 5 - One window is large (in the center at the top), other smaller windows are placed at the bottom and can overlap the larger one within reasonable limits
externVideoSlots List of video slots that are displayed on separate monitors
• callId - TrueConf ID, the unique identifier of a user
• monitorDisplayName - monitorName
• monitorIdx - Monitor index (used in the API)
• monitorIsPrimary - Monitor priority
hiddenVideoSlots The list of video slots removed from the layout
type The ype of content displayed in the video slot. It can be
• 0 - The video in the slot is sourced from the camera
• 1 - The video in the slot is the user's captured desktop
• 2 - The video in the slot is a captured application window, capture card, or slideshow
requestId A unique request identifier
result A flag indicating whether the request was successful

See also

Last Updated: 09/12/2025