Pular para o conteúdo principal

IMS Conference Server - Guia do Usuário

Visão Geral​

O IMS Conference Server fornece capacidades de conferência multiparte em conformidade com o 3GPP IMS Conference Framework (RFC 4579, RFC 4575, TS 24.147). Ele permite que assinantes criem e gerenciem conferências de áudio/vídeo através do IMS Application Server.

Arquitetura​

O IMS Conference Server é um componente integrado do OmniTAS que fornece:

  • Conference Factory URI: SIP URI para criar novas conferências
  • Conference Focus: Gerencia o estado da conferência e os participantes
  • Conference Policy Control: Impõe papéis e permissões dos participantes
  • Media Mixing: Lida com a mistura de áudio/vídeo para os participantes da conferência

Arquitetura da Conference Factory IMS​

O TAS implementa o padrão 3GPP Conference Factory conforme definido no TS 24.147 e RFC 4579:

Fluxo de Criação de Conferência (Padrão da Fábrica RFC 4579)​

Este diagrama mostra como um usuário cria uma nova conferência através do URI da Fábrica de Conferência:

Fluxo de Entrada de Participantes​

Este diagrama mostra como participantes adicionais entram em uma conferência existente:

Pacote de Eventos da Conferência (RFC 4575)​

O servidor de conferência envia notificações de estado da conferência para todos os participantes:

Operações de Gerenciamento de Conferência​

Operações realizadas através da Interface Web ou Console OmniTAS:

Acesso​

Interface Web​

Navegue até /conference ou clique em "Conferência" no menu de navegação para acessar a interface de Gerenciamento de Conferência.

Console OmniTAS​

Acesse o servidor de conferência a partir do console OmniTAS usando o comando ims_conference.

Recursos​

Interface de Gerenciamento de Conferência​

A interface web fornece monitoramento e gerenciamento em tempo real de conferências IMS ativas:

Painel de Estatísticas​

Exibe estatísticas de alto nível do servidor de conferência:

  • Conferências Ativas: Número total de conferências em andamento
  • Total de Participantes: Contagem combinada de participantes em todas as conferências
  • Conferências de Vídeo: Número de conferências com vídeo habilitado
  • Conferências Bloqueadas: Número de conferências bloqueadas para novos participantes

O painel também mostra a configuração do servidor:

  • Domínio: Domínio do servidor de conferência (por exemplo, conference.ims.local)
  • Factory URI: SIP URI para solicitações de criação de conferência
  • MNC/MCC: Código da Rede Móvel e Código do País
  • Rede de Acesso: Tipo de rede (por exemplo, 3GPP-E-UTRAN-FDD)
  • Máximo de Participantes Padrão: Máximo de participantes por conferência
  • Vídeo por Padrão: Se o vídeo está habilitado por padrão
  • Gravação Habilitada: Se a gravação da conferência está disponível

Lista de Conferências​

Mostra todas as conferências ativas com:

  • ID da Conferência: Identificador único para a conferência
  • URI: SIP URI da conferência
  • Participantes: Número atual de participantes
  • Criador: Número de telefone/URI do criador da conferência

Clique em qualquer conferência para expandir e ver informações detalhadas.

Detalhes da Conferência​

Expandir uma conferência mostra:

Informações da Conferência:

  • ID e URI
  • Nome da sala
  • Identidade do criador
  • Estado da conferência
  • Contagem de participantes (atual/máx e mínimo)
  • Status do vídeo (Habilitado/Desabilitado)
  • Status de bloqueio (Bloqueado/Desbloqueado)
  • Status de gravação (Ativo/Inativo)

Lista de Participantes:

  • SIP URI de cada participante
  • UUID da sessão
  • Estado do participante
  • Papel (0 = participante, 1 = moderador)
  • Status do vídeo

Ações da Conferência:

  • Bloquear/Desbloquear conferência
  • Habilitar/Desabilitar vídeo
  • (Ações adicionais disponíveis via CLI)

Atualização Automática​

A interface é atualizada automaticamente a cada 5 segundos para mostrar o status da conferência em tempo real. Você pode alternar a atualização automática on/off ou atualizar manualmente usando o botão "Atualizar".

Comandos do Console OmniTAS​

Todas as operações de gerenciamento de conferência estão disponíveis através do comando ims_conference no console OmniTAS.

Sintaxe do Comando​

ims_conference <comando> [argumentos]

Comandos Disponíveis​

list​

Lista todas as conferências IMS ativas.

omnitas@server> ims_conference list
Conferências IMS:
ID da Conferência        URI da Conferência                           Participantes Criador
================================================================================
1-1765699908         sip:conf-1-1765699908@conference.ims.local 3          19078720151

Total: 1 conferências

info​

Mostra informações detalhadas sobre uma conferência específica.

Sintaxe: ims_conference info <conf_id>

Importante: Use o ID da Conferência (por exemplo, 1-1765699908), não o nome da conferência com prefixo.

omnitas@server> ims_conference info 1-1765699908
Informações da Conferência:
  ID: 1-1765699908
  URI: sip:conf-1-1765699908@conference.ims.local
  Sala: ims-conf-1-1765699908
  Criador: 19078720151
  Estado: 1
  Participantes: 3/10 (mín: 2)
  Vídeo: Habilitado
  Bloqueado: Não
  Gravação: Inativa

Participantes:
  - sip:1235;phone-context=ims.mnc380.mcc313.3gppnetwork.org@ims.mnc380.mcc313.3gppnetwork.org;user=phone;method=INVITE (342d50e0-9f67-4cc5-9179-4acae6f65f34)
      Estado: 3, Papel: 0, Vídeo: Ligado
  - sip:1235;phone-context=ims.mnc380.mcc313.3gppnetwork.org@ims.mnc380.mcc313.3gppnetwork.org;user=phone;method=INVITE (bd98ca37-64fd-4618-b2db-aaba108c73e2)
      Estado: 3, Papel: 0, Vídeo: Ligado
  - 19078720151 (6270da85-9b94-4285-8130-8769b11d0aa2)
      Estado: 3, Papel: 1, Vídeo: Ligado

stats​

Exibe estatísticas gerais do servidor de conferência e configuração.

omnitas@server> ims_conference stats
Estatísticas do Servidor de Conferência IMS:
================================
Conferências ativas: 1
Total de participantes: 3
Conferências de vídeo: 1
Conferências bloqueadas: 0

Configuração:
  Domínio: conference.ims.local
  Factory URI: sip:conference-factory@conf-factory.ims.mnc380.mcc313.3gppnetwork.org
  MNC/MCC: 380/313
  Rede de Acesso: 3GPP-E-UTRAN-FDD
  Máximo de participantes padrão: 10
  Permitir anônimos: Sim
  Vídeo por padrão: Sim
  Gravação habilitada: Sim
  Anúncios: Entrada=Ativo, Saída=Ativo, Contagem=Ativo

create​

Cria uma nova conferência.

Sintaxe: ims_conference create <creator_uri>

omnitas@server> ims_conference create sip:19078720151@ims.local
Conferência criada: 1-1765699909
URI da Conferência: sip:conf-1-1765699909@conference.ims.local

destroy​

Termina uma conferência e desconecta todos os participantes.

Sintaxe: ims_conference destroy <conf_id>

omnitas@server> ims_conference destroy 1-1765699908
Conferência 1-1765699908 destruída

add​

Adiciona um participante a uma conferência existente.

Sintaxe: ims_conference add <conf_id> <sip_uri>

omnitas@server> ims_conference add 1-1765699908 sip:19078720152@ims.local
Adicionando participante sip:19078720152@ims.local à conferência 1-1765699908

remove​

Remove um participante de uma conferência.

Sintaxe: ims_conference remove <conf_id> <uuid>

Nota: Use o UUID da sessão do participante da saída do comando info.

omnitas@server> ims_conference remove 1-1765699908 342d50e0-9f67-4cc5-9179-4acae6f65f34
Participante removido da conferência 1-1765699908

lock​

Bloqueia uma conferência para impedir que novos participantes entrem.

Sintaxe: ims_conference lock <conf_id>

omnitas@server> ims_conference lock 1-1765699908
Conferência 1-1765699908 bloqueada

unlock​

Desbloqueia uma conferência para permitir novos participantes.

Sintaxe: ims_conference unlock <conf_id>

omnitas@server> ims_conference unlock 1-1765699908
Conferência 1-1765699908 desbloqueada

video​

Controla o vídeo para uma conferência.

Sintaxe: ims_conference video <conf_id> on|off

omnitas@server> ims_conference video 1-1765699908 on
Vídeo habilitado para a conferência 1-1765699908

omnitas@server> ims_conference video 1-1765699908 off
Vídeo desabilitado para a conferência 1-1765699908

record​

Controla a gravação da conferência.

Sintaxe: ims_conference record <conf_id> start|stop

omnitas@server> ims_conference record 1-1765699908 start
Gravação iniciada para a conferência 1-1765699908

omnitas@server> ims_conference record 1-1765699908 stop
Gravação parada para a conferência 1-1765699908

announce​

Toca um anúncio para todos os participantes da conferência.

Sintaxe: ims_conference announce <conf_id> <message>

omnitas@server> ims_conference announce 1-1765699908 "Esta conferência terminará em 5 minutos"
Anúncio enviado para a conferência 1-1765699908

subscribers​

Lista todos os assinantes atualmente em uma conferência (visualização alternativa para info).

Sintaxe: ims_conference subscribers <conf_id>

omnitas@server> ims_conference subscribers 1-1765699908
Assinantes na conferência 1-1765699908:
  - sip:1235;phone-context=ims.mnc380.mcc313.3gppnetwork.org@ims.mnc380.mcc313.3gppnetwork.org;user=phone;method=INVITE
  - 19078720151

Estados da Conferência​

Conferências e participantes têm valores de estado numéricos:

Estados da Conferência​

  • 0: Inicializando
  • 1: Ativo
  • 2: Terminando
  • 3: Terminado

Estados dos Participantes​

  • 0: Convidado
  • 1: Discando
  • 2: Alertando
  • 3: Conectado
  • 4: Desconectando
  • 5: Desconectado

Papéis dos Participantes​

  • 0: Participante regular
  • 1: Moderador/Criador

Casos de Uso​

Monitorando Conferências Ativas​

Cenário: A equipe de operações precisa ver quantas conferências estão ativas

Passos:

  1. Abra a interface de Gerenciamento de Conferência (/conference)
  2. Veja o Painel de Estatísticas para métricas de alto nível
  3. Revise a lista de conferências para conferências específicas
  4. Use a atualização automática para monitorar em tempo real

Alternativa CLI:

omnitas@server> ims_conference stats
omnitas@server> ims_conference list

Solucionando Problemas de Conferência​

Cenário: O usuário relata que não consegue entrar em uma conferência

Passos:

  1. Obtenha o ID da conferência do usuário
  2. Execute ims_conference info <conf_id> para verificar o estado da conferência
  3. Verifique se a conferência está bloqueada (Bloqueado: Sim)
  4. Verifique a contagem atual de participantes vs. máximo
  5. Revise a lista de participantes para quaisquer problemas de conexão
  6. Verifique os logs do OmniTAS para falhas de convite SIP

Problemas Comuns:

  • Conferência bloqueada: ims_conference unlock <conf_id>
  • Máximo de participantes atingido: Verifique a configuração default_max_participants
  • Problemas de rede: Verifique a conectividade SIP e as regras de firewall

Gerenciando a Largura de Banda da Conferência​

Cenário: Necessidade de reduzir o uso de largura de banda durante a congestão da rede

Passos:

  1. Identifique conferências com vídeo habilitado
  2. Para conferências não críticas, desabilite o vídeo: 
    ims_conference video <conf_id> off
  3. Monitore o uso de largura de banda
  4. Reabilite o vídeo quando a congestão diminuir

Lidando com Participantes Disruptivos​

Cenário: Um participante está sendo disruptivo em uma conferência

Passos:

  1. Obtenha o ID da conferência e o UUID da sessão do participante
  2. Remova o participante: 
    ims_conference remove <conf_id> <participant_uuid>
  3. Bloqueie a conferência para impedir que ele entre novamente: 
    ims_conference lock <conf_id>
  4. Adicione participantes legítimos manualmente, se necessário: 
    ims_conference add <conf_id> <sip_uri>

Gravando Conferências Importantes​

Cenário: Necessidade de gravar uma conferência para conformidade ou documentação

Passos:

  1. Identifique o ID da conferência
  2. Inicie a gravação: 
    ims_conference record <conf_id> start
  3. Monitore se a gravação está ativa (Gravação: Ativa na saída de info)
  4. Pare a gravação quando terminar: 
    ims_conference record <conf_id> stop
  5. Os arquivos de gravação são armazenados no diretório de gravações do OmniTAS

Terminação de Conferência de Emergência​

Cenário: Necessidade de terminar imediatamente uma conferência

Passos:

  1. Opcionalmente, anuncie aos participantes: 
    ims_conference announce <conf_id> "Esta conferência está sendo terminada"
  2. Aguarde alguns segundos para o anúncio ser reproduzido
  3. Destrua a conferência: 
    ims_conference destroy <conf_id>
  4. Todos os participantes serão desconectados imediatamente

Integração com a Rede IMS​

Fluxo de Criação de Conferência​

  1. O assinante envia SIP INVITE para o URI da fábrica de conferência
  2. O IMS Application Server recebe a solicitação
  3. O Servidor de Conferência cria uma nova instância de conferência
  4. O ID da conferência e o URI são gerados
  5. A política da conferência é inicializada com base no criador
  6. O criador é adicionado como o primeiro participante com papel de moderador
  7. O URI da conferência é retornado ao criador
  8. Outros participantes podem agora entrar via o URI da conferência

Papéis dos Participantes​

Moderador (Papel: 1)

  • Pode bloquear/desbloquear a conferência
  • Pode remover outros participantes
  • Pode controlar as configurações de vídeo
  • Recebe notificações da conferência

Participante (Papel: 0)

  • Pode entrar/sair da conferência
  • Pode falar e ouvir
  • Pode habilitar/desabilitar seu próprio vídeo
  • Sujeito às políticas da conferência

Conformidade com 3GPP​

O IMS Conference Server implementa especificações chave do 3GPP:

  • TS 24.147: Conferência usando o subsistema da Rede Central de Mídia IP (IM)
  • RFC 4579: Protocolo de Iniciação de Sessão (SIP) Controle de Chamada - Conferência para Agentes de Usuário
  • RFC 4575: Um Pacote de Eventos do Protocolo de Iniciação de Sessão (SIP) para Estado de Conferência
  • RFC 5239: Uma Estrutura para Conferência Centralizada

Integração de Elementos de Rede​

  • P-CSCF: Lida com o sinalização SIP inicial do UE
  • S-CSCF: Roteia solicitações de conferência para o Application Server
  • OmniTAS: Hospeda a funcionalidade do Servidor de Conferência e fornece mistura de mídia
  • HSS: Fornece autenticação e autorização de assinantes

Configuração​

A configuração do servidor de conferência é gerenciada através de arquivos de configuração do OmniTAS:

Parâmetros Chave:

  • domain: Domínio do servidor de conferência
  • factory_uri: SIP URI para criação de conferência
  • mnc_mcc: Identificadores da rede móvel
  • access_network: Tipo de acesso à rede
  • default_max_participants: Máximo padrão de participantes por conferência
  • allow_anonymous: Se permite participantes anônimos
  • video_by_default: Configuração padrão de vídeo para novas conferências
  • recording_enabled: Se a funcionalidade de gravação está disponível
  • announce_join: Tocar tom quando um participante entra
  • announce_leave: Tocar tom quando um participante sai
  • announce_count: Anunciar contagem de participantes

Melhores Práticas​

Planejamento de Capacidade​

  • Monitore a contagem de conferências ativas e a contagem de participantes
  • Planeje para uso máximo (por exemplo, horário comercial)
  • Alocar CPU/memória suficientes para mistura de mídia
  • Considere vídeo vs. apenas áudio para gerenciamento de largura de banda

Segurança​

  • Assegure que os URIs das conferências não sejam facilmente adivinháveis
  • Use bloqueio de conferência para conferências privadas
  • Monitore tentativas de acesso não autorizadas
  • Implemente limites máximos de participantes
  • Revise os controles de acesso às gravações da conferência

Monitoramento Operacional​

  • Configure alertas para erros do servidor de conferência
  • Monitore taxas de criação/destruição de conferências
  • Acompanhe a duração média da conferência
  • Revise falhas de conexão de participantes
  • Monitore métricas de qualidade de mídia

Para documentação detalhada de métricas: Veja metrics.md para:

  • Métricas de qualidade de mídia RTP/RTCP (Porta 9093)
  • Métricas de chamadas e sessões ativas (Porta 9090)
  • Métricas do sistema e da VM Erlang (Porta 8080)
  • Exemplos de consulta do Prometheus

Solução de Problemas​

  • Verifique os logs do OmniTAS para erros relacionados à conferência
  • Verifique a conectividade SIP entre participantes e servidor de conferência
  • Monitore fluxos de mídia RTP para perda de pacotes
  • Verifique a disponibilidade de largura de banda da rede
  • Verifique a compatibilidade do dispositivo do participante

Limitações​

  • Máximo de participantes por conferência: Configurável (padrão: 10)
  • Máximo de conferências simultâneas: Limitado pelos recursos do servidor
  • Qualidade do vídeo: Depende da largura de banda da rede e dos dispositivos dos participantes
  • Formato de gravação: Determinado pela configuração do OmniTAS
  • Formato do ID da conferência: Gerado automaticamente, não pode ser personalizado via interface web

Suporte​

Para problemas ou perguntas sobre o IMS Conference Server:

  1. Verifique os logs do OmniTAS para mensagens de erro
  2. Verifique a configuração do servidor de conferência
  3. Revise a conectividade da rede e as regras de firewall
  4. Entre em contato com o suporte da Omnitouch com o ID da conferência e os timestamps