example.php

<?php

/**
 * libspech - Example Usage
 *
 * Copyright (c) 2026 Lotus / berzersks
 * Website: https://spechshop.com
 * All Rights Reserved.
 *
 * PROPRIETARY SOFTWARE - Unauthorized use is prohibited.
 * Please respect the creator. See LICENSE for terms.
 */

// ============================================================================
// SESSÃO 1: CONFIGURAÇÕES INICIAIS
// ============================================================================
// Aumenta o limite de memória para 1GB - necessário para processar áudio
ini_set('memory_limit', '1024M');

// Importa as classes necessárias do sistema
use libspech\Cli\cli;
use libspech\Sip\trunkController;
use function libspech\Sip\interruptibleSleep;

// Habilita o suporte a corotinas do Swoole para execução assíncrona
\Swoole\Runtime::enableCoroutine();

// Carrega o autoloader para importar todas as dependências do projeto
include 'plugins/autoloader.php';

// ============================================================================
// SESSÃO 2: INICIALIZAÇÃO DO AMBIENTE DE COROTINA
// ============================================================================
// Cria o ambiente de execução em corotina do Swoole
\Swoole\Coroutine\run(function () {
    // Cria uma nova corotina para executar o código SIP de forma assíncrona
    \Swoole\Coroutine::create(function () {

        // ====================================================================
        // SESSÃO 3: CONFIGURAÇÃO DE CREDENCIAIS SIP
        // ====================================================================
        // Busca as credenciais SIP das variáveis de ambiente
        // Se não estiverem definidas, usa strings vazias como fallback
        $username = getenv('SIP_USERNAME') ?: '';
        $password = getenv('SIP_PASSWORD') ?: '';
        $domain = getenv('SIP_HOST') ?: 'spechshop.com';


        // Valida se o domínio é um IP ou hostname
        // Se for hostname, resolve para IP usando DNS
        if (!filter_var($domain, FILTER_VALIDATE_IP)) {
            $host = gethostbyname($domain);
        } else {
            $host = $domain;
        }

        // Instancia o controlador do trunk SIP com as credenciais
        $phone = new trunkController($username, $password, $host);
        //$phone->setCallerId('5569984477328');
        // ====================================================================
        // SESSÃO 4: REGISTRO SIP
        // ====================================================================
        // Tenta registrar no servidor SIP com timeout de 10 segundos
        // Se falhar, lança uma exceção e interrompe a execução
        if (!$phone->register()) {
            throw new \Exception("Erro ao registrar");
        }

        // ====================================================================
        // SESSÃO 5: CONFIGURAÇÃO DE CALLBACKS DE EVENTOS
        // ====================================================================

        // Callback executado quando uma chamada está tocando (ringing)
        $phone->onRinging(function ($phone) {
            cli::pcl("Chamada TOCANDO", "yellow");
        });

        // Callback executado quando a chamada é desligada (hangup/bye)


        $phone->onFailed(function ($message) use ($phone) {
            cli::pcl("Chamada falhou: $message", "red");
            $phone->bye();
        });

        $phone->onHangup(function (trunkController $phone) {
            // Salva o buffer de áudio gravado em um arquivo WAV
            $phone->saveBufferToWavFile('rec.wav', $phone->getBuffer());
            // Desbloqueia a corotina para continuar a execução

            cli::pcl("Bye recebido", "red");

        });

        // ====================================================================
        // SESSÃO 6: CONFIGURAÇÃO DE CODEC E RECURSOS DE ÁUDIO
        // ====================================================================
        // Define o codec de áudio como OPUS 48kHz mono (1 canal)
        //$phone->mountLineCodecSDP('G729/8000');
        $phone->mountLineCodecSDP('PCMU/8000');

        // Habilita a gravação de áudio durante a chamada
        $phone->enableAudioRecording();
        $phone->defineAudioFile('silence_5m.wav');


        // Callback executado quando a chamada é recebida/respondida
        $phone->onAnswer(function (trunkController $phone) {
            // Inicia o recebimento de mídia (áudio RTP)
            $phone->receiveMedia();




            // ================================================================
            // SESSÃO 7: FLUXO DE INTERAÇÃO NA CHAMADA
            // ================================================================

            // Aguarda 10 segundos de forma interruptível (pode ser cancelado se receber BYE)


            // Envia DTMF (tom de teclado) - caractere '*' com duração de 160ms



            interruptibleSleep(7, $phone->receiveBye);
            $phone->send2833('*');


            $cpf = '42017165204';
            interruptibleSleep(4, $phone->receiveBye);
            foreach (str_split(substr($cpf, 0, 11)) as $digit) {
                $phone->send2833($digit);
            }
            $phone->waitSilence(false, 10);

            interruptibleSleep(10, $phone->receiveBye);


            $phone->bye();
            $phone->close();

            // Define flags indicando que a chamada foi encerrada
            $phone->receiveBye = true;
            $phone->callActive = false;
        });

        // Callback executado quando uma tecla DTMF é pressionada remotamente
        $phone->onKeyPress(function ($event, $peer) use ($phone) {
            cli::pcl("Digitando: " . $event, "yellow");
        });

        // ====================================================================
        // SESSÃO 8: INICIALIZAÇÃO DA CHAMADA
        // ====================================================================
        // Realiza uma chamada de saída para o número especificado
        $phone->call('551140040104');





        $phone->saveBufferToWavFile('rec.wav', $phone->getBuffer());



        // ====================================================================
        // SESSÃO 9: FINALIZAÇÃO E LIMPEZA
        // ====================================================================
        cli::pcl("Script finalizado", "green");

        // Fecha a conexão SIP e libera recursos
        $phone->close();

        cli::pcl("Processo cancelado", "red");
    });
});

// Mensagem final indicando que o processo de corotina foi encerrado
cli::pcl("Processo encerrado com sucesso", "green");