Orientações para a configuração de

câmeras e de parâmetros do VTraining

(Documento criado por Cirano Iochpe - 28/09/2022 - Atualizado em 29/09/2022)

1. Acessando a ficha de configuração da câmera a partir do cadastro de câmeras

do VTraining
Para acessar a “ficha de configuração” da câmera, a partir do VTraining, basta clicar no IP
associado a ela em sua linha de cadastro no Cadastro de Câmeras do software. Antes disso,
porém, é importante obter os valores de login e senha da câmera, dois campos do cadastro no
VTraining. As imagens, abaixo, ilustram esta sequência de passos.
2
2. Configurando a câmeras através de campos do formulário em hipertexto da
ficha
Uma vez tendo se logado no formulário de configuração da câmera é apresentado seu menu
principal na página.
Clicando em qualquer dos ícones (links) do menu é possível chegar a submenus até que se chega
nos formulários onde os campos, na maioria das vezes, já estão preenchidos com valores default
(usuais determinados pelo fabricante)
É possível alterar os valores dos campos. E as próximas imagens indicam a sequência de menus,
submenus e formulários que devem ser visitados na página da câmera.
Para cada campo de formulário mostrado nas imagens abaixo, já está escrito o valor que deve ser
usado para compatibilizar a configuração da câmera com o funcionamento do VTraining.

Na imagem acima é apresentado o menu principal da página de configuração da câmera. Inicia-se

pelas configurações relativas a vídeo. As imagens abaixo apresentam os valores de configuração
de vídeo.

3
Mesmo que a câmera ofereça 03 streams de vídeo para configurar, o VTraining só utiliza o STREAM
PRINCIPAL e o STREAM EXTRA 01. As imagens do mosaico são compostas por fluxos transmitidos
conforme a configuração do stream extra 01. Isso também ocorre na gravação de treinamento do
VTraining, quando o parâmetro “rec_second_stream = true” no software (estes parâmetros serão
apresentados mais adiante no texto).
O stream extra 01 tem configuração mais leve para não sobrecarregar a rede quando o mosaico,
com todas as câmeras, é transmitido para os computadores visualizadores e apresentado no
navegador Chrome do usuário.
Já o stream principal é usado na apresentação das câmeras nas salas de treinamento, para que se
perceba as imagens em maior nível de detalhes. Quando o parâmetro “rec_second_stream =
false”, também os vídeos gravados pelo RECORDER usam o stream principal, o que aumenta o
espaço de armazenamento, no STORAGE, usado para armazenar os vários vídeos de cada
gravação.
Os principais campos que diferenciam a configuração dos dois streams são: resolução da imagem
e taxa de bits. Na imagem acima, o leitor já encontra, para cada campo de cada stream, os valores
compatíveis com o funcionamento do VTraining. São estes valores que devem ser escritos sempre
que possível.
Para salvar as configurações em qualquer um dos formulários da página da câmera, o usuário
administrador deve clicar no botão “SALVAR” e esperar uma notificação da câmera, confirmando o
salvamento dos valores. Só então, o usuário pode sair da tela do formulário e voltar ao menu
imediatamente anterior. Há telas em que se alcança o botão de salvar movendo a barra de
rolagem do formulário para baixo.
A seguir, são apresentados os valores que devem ser preenchidos no formulário de configuração
de rede da câmera.

4
Os valores dos campos de rede, muitas vezes, são dependentes da infraestrutura de redes da TI da
instituição cliente do VTraining. Sendo assim, é conveniente sempre questionar o pessoal técnico
de redes da i9Access sobre estes valores e testar a transmissão das imagens da câmera ao
VTraining através da rede.
Nas configurações gerais do sistema é possível, dentre outras coisas, determinar como a câmera
manterá a data e a hora atuais a cada momento. Veja nas imagens abaixo.

5
As imagens a seguir apresentam a configuração no submenu intitulado Manutenção. Nele é
possível configurar a câmera para reiniciar automaticamente, todos os dias, em horário da

6
madrugada. É também no formulário de Manutenção que se pode reiniciar a câmera
manualmente a qualquer momento (botão “Reiniciar Agora”).

Um outro submenu importante dentro do menu sistema é o de Interface. Há formulários em que

se pode configurar a câmera para não mostrar nem labels ou marcas d’água (ex.: Intelbras) nem
data nas imagens que irá capturar e enviar ao VTraining pela rede.
Abaixo, são apresentadas duas telas do submenu Interface, onde se deve desabilitar a
apresentação de datas e marcas d’água.

7
O próximo submenu que pode nos interessar em sistemas é o de Serviços. A configuração dos
parâmetros de transmissão de voz pelo protocolo SIP são configurados neste menu.
O SIP só é importante quando o VTraining envia “voz de deus” e mensagens de voz pré-gravadas
(botões de voz à direita do mosaico) para a câmera, através de uma ligação VoIP feita no protocolo
SIP. Em recebendo a ligação, a câmera converte o som digital para formato analógico e envia (por

8
um cabo de som) para um amplificador que, por sua vez, envia o som amplificado para as caixas
de som instaladas na sala de simulação ou de debriefing.
Se o VTraining envia os sons, a partir das telas do mosaico e da sala de treinamento, por ligação
VoIP, não para a câmera, mas sim para o TDV (transmissor digital de voz), não é necessário, a
princípio, fazer qualquer configuração no submenu de Serviços.

9
O último submenu de Sistemas que nos interessa é o de Parâmetros. Nele, ajustamos o perfil e
fixamos as bases de funcionamento do zoom e do foco da câmera.

10
Encerramos a configuração das telas do menu Sistema. Agora, se volta ao menu principal e
seleciona-se o submenu Ajustes, onde configuramos o som do microfone da câmera.

11
É pela entrada do microfone da câmera que ela recebe o som ambiente da sala de simulação. Se o
microfone não vem embutido na própria câmera, geralmente se instala um microfone cardióide
no teto da sala que transmite o som ambiente até uma mesa de som e, desta, parte um cabo de
som analógico que é conectado na entrada de microfone da câmera.
Nem o microfone cardióide nem a mesa de som são necessários se a câmera já tiver um microfone
embutido (ex.: Intelbras VIP 3230 DZ G3).

O stream principal, que não aparece na imagem acima, deve ser configurado da mesma forma que
o stream extra.

12
O som ambiente é transmitido pelos dois streams para que chegue no mosaico e na sala de
treinamento do VTraining no navegador Chrome.
Note que o campo do supressor de ruído é mantido inativo para a boa recepção de voz pelo
VTraining.
A saída da página de configuração da câmera se dá no sentido inverso da árvore de menus.
Primeiro se retorna ao menu principal e depois à página inicial onde se encontra, no topo, à
direita, o símbolo de “logout”.

13
3. Configurando uma sala de treinamento nos cadastros do VTraining
Após o registro, no Cadastro de Câmeras do VTraining, de todas as câmeras e de cada um dos
outros dispositivos IP que irão se comunicar por voz, vídeo ou ambos com o software (ex.: monitor
multiparamétrico, streamer, transmissor digital de voz), o usuário administrador deve cadastrar e
configurar as salas monitoradas. São as salas de treinamento e, eventualmente, as salas de
debriefing quando estas últimas também tiverem câmeras.
No formulário de registro de uma sala monitorada, o usuário administrador deve preencher o
nome da sala, pode escrever uma descrição da mesma e especificar seu tipo (ex.: high_tech) e sua
localização (ex.: segundo andar do CSR).
Além disso, é muito importante especificar quais dispositivos IP estarão atuando na sala (ex.:
câmeras, TDV, multiparamétricos, streamers) e quais funções cada um deles irá assumir nesta sala
(ex.: Vídeo ativo na sala, Saída de som ativa na sala, Microfone ativo na sala). Cada dispositivo
pode assumir mais de uma função simultaneamente na configuração da sala.

14
4. Configuração do parâmetros de execução do VTraining
O VTraining apresenta um conjunto de parâmetros de configuração que influenciam sua execução.
Na instalação do software, estes parâmetros são carregados de um arquivo especial. Cada
parâmetro já vem com seu valor default, ou seja, valor usualmente aplicado ao parâmetro nas
diferentes instalações do VTraining
Contudo, dependendo da forma como a instituição deseja utilizar diferentes funções do sistema, é
possível alterar-se os valores de um ou mais destes parâmetros, utilizando-se a interface do
VTraining apresentada no navegador Chrome.
A seguir, através de imagens da interface do VTraining é indicada a navegação para se chegar à
lista de parâmetros e é apresentado o valor usualmente atribuído a cada um deles.

15
16
5. ANEXO 01 - Significado dos parâmetros de configuração do VTraining
Nosso ex-colaborador, Augusto Klinger, um dos desenvolvedores do VTraining, detalhou a lista dos
parâmetros mais usados na configuração do software e explicou para que serve cada um deles.
Este anexo apresenta o documento elaborado pelo Augusto.

17
 Vtraining Parâmetros – Descrição Oficial
(Descrição feita por Augusto Klinger – 03/09/2022)

checked_quick_mode

SystemParameter.find_or_create_by(key: 'checked_quick_mode', value: 'false')

Deixa o “modo rápido” selecionado por padrão. O modo rápido inicia a gravação assim que
se acessa uma sala. Ele gera uma gravação temporária.

debriefing_interval

SystemParameter.find_or_create_by(key: 'debriefing_interval', value: '10000')

Em milissegundos, é a frequência com que a interface verifica se a gravação está ainda

funcionando. Valores menores darão um feedback mais preciso, porém podem tornar a aba
do browser mais pesada pelo volume de mensagens trocadas com o backend.

simple_debriefing

SystemParameter.find_or_create_by(key: 'simple_debriefing', value: 'true')

Não funciona mais. Quando desabilitado, utilizava o app da mconf para abrir as salas.

robot_import_enabled

SystemParameter.find_or_create_by(key: 'robot_import_enabled', value: 'false')

Habilita um botão dentro da tela de visualização de gravações que permite o upload de um

arquivo com os dados de simulação de um robô da marca XXXXX (Global?). Os dados então
aparecem na timeline.

room_allocation_margin

SystemParameter.find_or_create_by(key: 'room_allocation_margin', value: '30')

Tempo, em minutos, que uma sala permanece alocada para um treinamento antes e após o
horário cadastrado.

18
rec_tmp_days

SystemParameter.find_or_create_by(key: 'rec_tmp_days', value: '90')

Em dias, quanto tempo uma gravação temporária (modo rápido) fica armazenada. Ver
parâmetro checked_quick_mode.

recordings_big

SystemParameter.find_or_create_by(key: 'recordings_big', value: 'false')

Apresenta a tela de reprodução das gravações em um padrão mais semelhante ao do

debriefing. Os vídeos ocupam uma porção maior da tela em relação aos comentários.
Recomendado deixar habilitado.

Parâmetros de servidor de email

SystemParameter.find_or_create_by(key: 'mail_address', value: 'smtp.gmail.com')

SystemParameter.find_or_create_by(key: 'mail_port', value: '587')

SystemParameter.find_or_create_by(key: 'mail_username', value: 'i9vtraining')

SystemParameter.find_or_create_by(key: 'mail_password', value: 'i9suporte')

Servidor SMTP e usuário que é utilizado para o envio de e-mail. É usado quando se
compartilha uma gravação por e-mail através do botão da tela de visualização de gravações,
por exemplo.

version

SystemParameter.find_or_create_by(key: 'version', value: '1.6.2')

Costumava atualizar esse valor a cada release do Vtraining, para saber quais features e bugs
estão presentes nas instalações dos clientes.

19
send_comm_button

SystemParameter.find_or_create_by(key: 'send_comm_button', value: 'false')

A tela da sala, debriefing, permite comentários na timeline. Esse parâmetro adiciona um

botão para ser clicado e adicionar o comentário digitado. Para quem não quer apertar
ENTER, tem essa alternativa do botão.

checked_recs_view

SystemParameter.find_or_create_by(key: 'checked_recs_view', value: 'false')

Na visualização das gravações, tem um checkbox para exibir um vídeo em destaque (um
vídeo fica maior que os outros, e pode-se trocar qual vídeo fica no destaque clicando sobre
eles). Esse parâmetro deixa o modo com um vídeo em destaque habilitado por padrão
sempre que acessar para visualizar uma gravação.

post_processing_video

SystemParameter.find_or_create_by(key: 'post_processing_video', value: 'false')

Se habilitado, o vídeo que originalmente é gravado em mkv é transcodificado para mp4. O

processo toma alguns minutos, e por isso deixamos desabilitado por padrão, para que
possam visualizar a gravação imediatamente após a execução do cenário.

ws_ffmpeg_url

SystemParameter.find_or_create_by(key: 'ws_ffmpeg_url', value: 'ws://localhost:8096')

Aponta para o servidor que está sendo utilizado com o módulo gravador.

ffmpeg_rec

SystemParameter.find_or_create_by(key: 'ffmpeg_rec', value: 'true')

Gravação com o gravador do Vtraining. Antigamente, a gravação era feita pelo Kurento, o
que era bastante custoso computacionalmente, e sempre gerava erros. Não é recomendado
desabilitar esse parâmetro.

20
restrict_groups

SystemParameter.find_or_create_by(key: 'restrict_groups', value: 'false')

É possível criar grupos de usuários e esse parâmetro, se habilitado, permite que somente
usuários de um mesmo grupo vejam as gravações um dos outros.

rec_default_tmp

SystemParameter.find_or_create_by(key: 'rec_default_tmp', value: 'true')

Gravações do modo rápido são armazenadas como temporárias por padrão. Desabilitar essa
flag faz com que as gravações do modo rápido nunca sejam excluídas automaticamente.

n_access_only_to_admin

SystemParameter.find_or_create_by(key: 'n_access_only_to_admin', value: 'false')

Faz com que os usuários que não são do perfil admin possam acessar cada gravação apenas
uma única vez.

manual_rec

SystemParameter.find_or_create_by(key: 'manual_rec', value: 'false')

Permite clicar no botão de gravação para iniciar e pausar a gravação.

status_json

SystemParameter.find_or_create_by(key: 'status_json', value: 'false')

Caminho para o json que apresenta o status do Kurento (ex.:

"https://qas-vt-apps.inf.ufrgs.br/mosaic/status.json")

report_mails

SystemParameter.find_or_create_by(key: 'report_mails', value: 'suporte@i9access.com.br')

Email para o qual são enviados os reports de incidências no sistema.

21
rec_second_stream

SystemParameter.find_or_create_by(key: 'rec_second_stream', value: 'false')

Quando habilitado, grava o stream secundário das câmeras ao invés do principal. Isso gera
gravações de menor qualidade, mas muito mais leves.

sync_rec

SystemParameter.find_or_create_by(key: 'sync_rec', value: 'false')

Quando visualizando gravações, esse parâmetro força com que todos os vídeos estejam no
mesmo ponto, quando avançado ou retrocedido na barra de duração. Fica bastante pesado
se os vídeos forem de alta qualidade. Desabilitado, os vídeos podem não estar exatamente
no mesmo ponto, mas vão se alcançando assincronamente.

show_before_training

SystemParameter.find_or_create_by(key: 'show_before_training', value: '60')

Em minutos, quanto tempo antes do horário agendado o treinamento aparece na tela de

acesso às salas.

is_lifelong

SystemParameter.find_or_create_by(key: 'is_lifelong', value: 'true')

Licença permanente.

experation_date

SystemParameter.find_or_create_by(key: 'experation_date', value:

d.next_month.strftime("%d/%m/%Y"))

Data de expiração da licença.

22