Труконф

# getVideoMatrix

Описание: получить информацию о текущей раскладке.

Пример запроса:

{
    "method" : "getVideoMatrix",
    "requestId" : "1"
}

Пример ответа:

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

Описание параметров:

  • selfViewMode - режим селфвью. Может быть:

    • 1 - селфвью поверх раскладки

    • 2 - селфвью в раскладке

  • participants - список видеослотов

    • peerId - уникальный идентификатор пользователя TrueConf ID, от которого показывается видео. #self:0 - всегда обозначает видеослот с камерой VideoSDK/Room

    • peerDn - отображаемое имя пользователя

    • title - название слайдшоу от участника. Поле присутствует только для SlideShowSlot

    • top - y-координата

    • left - x-координата

    • width - ширина

    • height - высота

  • mainWindowWidth - ширина видеообласти, на которой располагаются видеослоты

  • mainWindowHeight - высота видеообласти, на которой располагаются видеослоты

  • matrixType - тип матрицы размещения. Матрица бывает следующих типов:

    • 0 - показывать только одно окно. При этом если в списке окон больше - будет показано первое

    • 1 - все окна одинаковые

    • 2 - одно окно большое (в левом верхнем углу), остальные маленькие вокруг него

    • 3 - одно окно большое (по центру сверху), остальные маленькие снизу

    • 4 - одно окно большое (в левом углу), остальные маленькие справа от него

    • 5 - одно окно большое (по центру сверху), остальные маленькие снизу, которые могут "наползать" на него в разумных пределах

  • externVideoSlots - список видеослотов, которые вынесены на отдельные мониторы

    • callId - уникальный идентификатор пользователя TrueConf ID (аналог peerId)

    • monitorDisplayName - имя монитора

    • monitorIdx - индекс монитора (используется в API)

    • monitorIsPrimary - первичность монитора

  • hiddenVideoSlots - список скрытых видеослотов из раскладки

  • requestId - уникальный идентификатор запроса. Детальнее с ним можно ознакомиться здесь

См. также: