Modo Quiosque

O Modo Quiosque, disponível no iDFace Max, substitui a tela principal do dispositivo por uma interface personalizável, com cabeçalho, mensagens, cores, ícones e botões configuráveis. Os botões são gerenciados através do objeto kiosk_buttons e podem executar ações como abrir a lista de contatos da interfonia SIP, liberar a porta por PIN ou realizar a leitura de QR code.

Configurações do Modo Quiosque

Configurações gerais do Modo Quiosque. Os parâmetros abaixo pertencem ao módulo guiFaceID e podem ser alterados através do comando set_configuration.fcgi.

Campo	Tipo	Descrição
kiosk_mode_enabled	int	Habilita / desabilita o Modo Quiosque. Valores: "0" para desabilitado e "1" para habilitado.
kiosk_header_title	string	Texto principal mostrado no cabeçalho da tela principal.
kiosk_header_subtitle	string	Texto secundário mostrado no cabeçalho da tela principal.
kiosk_message_title	string	Texto principal mostrado no meio da tela principal.
kiosk_message_subtitle	string	Texto secundário mostrado no meio da tela principal.
kiosk_text_color	string	Cor de todos os textos mostrados na tela principal. O valor deve ser uma cor hexadecimal com prefixo #.
kiosk_device_name	string	Texto com o nome do dispositivo mostrado na barra superior na tela principal.
kiosk_general_icons_color	string	Cor de todos os ícones mostrados na tela principal e telas derivadas. Valor deve ser uma cor hexadecimal com prefixo #.

Exemplo de requisição

Essa requisição configura os parâmetros do modo quiosque.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST', 
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "guiFaceID": {
                "kiosk_mode_enabled": "1",
                "kiosk_header_title": "The Pike",
                "kiosk_header_subtitle": "227 Pane Road, Newington",
                "kiosk_message_title": "Hi",
                "kiosk_message_subtitle": "Detectando\nRosto ou QR code...",
                "kiosk_text_color": "#FFFFFF",
                "kiosk_device_name": "ACCESS",
                "kiosk_general_icons_color": "#000000"
            }
        }
    )
});

GET /get_kiosk_icons_list.fcgi

Obtém uma lista de ícones carregados no Modo Quiosque.

Parâmetros

• Essa requisição não possui parâmetros.

Resposta

• icons (array): Um array com objetos contendo o filename de cada ícone.
• max_files (int): Indica o número máximo de ícones.

Exemplo de requisição

$.ajax({
    url: "/get_kiosk_icons_list.fcgi?session=" + session,
    type: 'GET'
});

Exemplo de resposta

{
    "icons": ["mykioskicon"],
    "max_files": 4   
}

GET /get_kiosk_icon.fcgi

Obtém o arquivo do ícone selecionado.

Parâmetros

• filename (string): Nome do arquivo.

Resposta

• O arquivo do ícone.

Exemplo de requisição

$.ajax({
    url: "/get_kiosk_icon.fcgi?filename=mykioskicon&session=" + session,
    type: 'GET'
});

POST /set_kiosk_icon.fcgi

Carrega um ícone.

Parâmetros

• filename (string): Nome do arquivo.
• Ícone (binário) a ser carregado no dispositivo.

Resposta

• success (boolean): Indica o sucesso da operação.
• filename (string): Nome do arquivo enviado.

Exemplo de requisição

$.ajax({
    url: "/set_kiosk_icon.fcgi?filename=mykioskicon&session=" + session,
    type: 'POST',
    contentType: 'application/octet-stream',
    processData: false,
    data: image
});

Exemplo de resposta

{
    "success": true,
    "filename": "mykioskicon"
}

POST /delete_kiosk_icon.fcgi

Deleta um ícone.

Parâmetros

• filename (string): Nome do arquivo.

Resposta

• success (boolean): Indica o sucesso da operação.

Exemplo de requisição

$.ajax({
    url: "/delete_kiosk_icon.fcgi?filename=mykioskicon&session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify({})
});

Exemplo de resposta

{
    "success": true
}

Bloqueio por tentativas de autenticação

No Modo Quiosque, é possível bloquear temporariamente a autenticação por PIN ou QR code após múltiplas falhas consecutivas. Esses parâmetros pertencem ao módulo identifier (veja Parâmetros de configuração).

Campo	Tipo	Descrição
kiosk_block_enabled	int	Habilita / desabilita o mecanismo de bloqueio PIN ou QR code no caso de múltiplas falhas de autenticação. Valores: "0" para desabilitado e "1" para habilitado.
kiosk_max_attempts	int	Número máximo de tentativas antes do bloqueio.
kiosk_block_interval	int	Duração do bloqueio em segundos.

Exemplo de requisição

Essa requisição habilita o bloqueio após 3 tentativas malsucedidas, com duração de 60 segundos.

$.ajax({
    url: "/set_configuration.fcgi?session=" + session,
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(
        {
            "identifier": {
                "kiosk_block_enabled": "1",
                "kiosk_max_attempts": "3",
                "kiosk_block_interval": "60"
            }
        }
    )
});