MediaCP Manual
Guia de integração do WHMCS

Last updated 1 mês atrás

Visão geral

A integração com o WHMCS permite configurar planos de serviço para vender serviços de streaming de áudio e vídeo com configuração e provisionamento automáticos de contas de clientes e streaming.

Notas de versão do módulo

O Changelog está disponível no GitHub.

Módulo WHMCS

Instalar o módulo mais recente

1. Certifique-se de que tem a versão mais recente do MediaCP

2. Baixe a versão mais recente do módulo MediaCP para WHMCS

3. Extraia o arquivo .zip para sua área de trabalho

4. Conecte-se ao seu servidor WHMCS via FTP e navegue até [WHMCS]/modules/servers

5. Arraste e solte a pasta mediacp da sua área de trabalho para o seu cliente FTP para carregar os arquivos.

6. Agora você deve ver a pasta mediacp dentro do seu [WHMCS]caminho /modules/servers no servidor ftp

Adicionando um servidor no WHMCS

  1. Faça login no WHMCS como administrador e navegue até
    Configurações do Sistema.
  2. Selecione Produtos e Serviços from no menu à esquerda e, em seguida, selecione a opção Servidores .
  3. Selecione o botão + Adicionar Novo Servidor na parte superior da página e preencha o formulário.
  4. Selecione
    Ir para o Modo Avançado
  5. Preencha o formulário de acordo com os detalhes abaixo:
    • Nome – Insira um rótulo para este servidor.
    • Nome do host – Insira o nome de domínio ou subdomínio primário no qual o MediaCP está instalado, como streaming.myserver.com
    • Endereço IP – insira o endereço IP do servidor MediaCP, este será utilizado pelo WHMCS para validar o acesso às portas.
    • Endereço de status do servidor – Isso é usado para fornecer o status da rede e carregar para WHMCS. O MediaCP fornece uma URL especial para você colar na configuração do Servidor WHMCS. Para exibir o status Online no WHMCS, você deve primeiro garantir que a Porta 80 do MediaCP esteja habilitada.

      O formato do Endereço de Status do WHMCS é descrito abaixo, substituindo yourdomain.com:2020 pelo nome de host e porta MediaCP e
      {api-key}
      pela sua Chave de API MediaCP.

      https://yourdomain.com:2020/whmcs-status/{api-key}/

      Exemplo:

      https://demo.mediacp.net/whmcs-status/iMtTpHvVWMjMh8dZgn6n0Vqoq3aWyomKmp-KjMV9W5uY06eepH2Mxg==/
    • Módulo – Painel de Controle de Mídia
    • Nome de usuário – Nome de usuário do administrador, o padrão é “admin”
    • Senha- Este campo não é usado.
    • Hash de acesso – Forneça a chave de API MediaCP neste campo.
    • Seguro – Marque esta caixa se HTTPS/SSL estiver configurado com MediaCP (ON padrão).
    • Porta – A porta primária que o software MediaCP utiliza. O padrão é 2020. Altere somente se você tiver configurado uma porta alternativa para o MediaCP Web.
    • Servidores de Nomes – esta informação não é exigida pelo módulo MediaCP.
  6. Pressione o botão Salvar alterações para concluir.

Criando seu primeiro produto

Agora você está pronto para criar e configurar seu primeiro produto para o MediaCP.

1. Navegue até Configuração -> Produtos/Serviços. Em seguida, clique em Criar um novo produto.

2. Selecione Conta de Hospedagem Compartilhada e selecione um grupo de produtos e nome adequados e clique em Continuar.

novo produto

3. Selecione a guia Configurações do módulo e preencha as configurações básicas conforme a preferir.

whmcs_module_settings

4. Pressione Salvar alterações

Adicional

Opções configuráveis

Você pode permitir que seus clientes criem seus próprios pacotes definindo Opções Configuráveis.

  1. Navegue até opçõesconfiguráveis de configuração-produtos/serviços.
  2. Pressione Criar um Novo Grupo
  3. Configure o Nome do Grupo e os Produtos Atribuídos e pressione Adicionar Nova Opção Configurável.
  4. Consulte a tabela abaixo para criar suas opções de pacote. É importante que as opções sejam rotuladas corretamente, você pode optar por usar a opção configurável ou alternativas para os nomes de opção.

das opções de

Serviço de mídia – Shoutcast shoutcast 2shoutcast 198Icecast Icecast 2Icecast 2 KHIcecast KHWowza streaming EngineFlash Media ServiceWindows Media Serviços de Fonte AutoDJ Shoutcast Transcoder v1shoutcast transcoder v2ICES 0,4 (mp3)ICES 2,0 (OGG)Stream Transcoder v3 Alternativamente, você pode definir esse valor como “Yes” e o módulo configurará automaticamente o shoutcast Transcoder v2.

montagem

de

Proxy

de fluxo

Locking

Recodificar

Conexões Ouvintesespectadoresmáximo usuáriosmáximo ouvintesmáximo espectadores Valor numérico Insira um valor entre 0 e 9999. Bitrate Bitrate máximo 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 400, 480, 560, 640, 720, 800, 920, 1024, 1280, 1536, 1792, 2048, 2560, 3072, 3584, 4096, 99999

Uso de disco Cota de disco de cotade disco MB, GB ou TB

Transferência de dados Largurade banda de transferência MB, GB ou TB

Relatórios

Autenticação de

fluxo

de fluxo

Descrição opções configuráveis
Pontos de Valor numérico Número pontos de montagem que o serviço Shoutcast ou Icecast incluirá.
Deve ser um inteiro.
AutoDJ Sources Numerical Value Número de fontes AutoDJ que podem ser aplicadas a pontos de montagem nos serviços Shoutcast e Icecast.
Deve ser um inteiro.
de fluxo Proxy Sim
Não
Habilitar ou desabilitar o proxy de fluxo HTTP/HTTPS na conta
Geo Geolock
País Locking Sim
Não Permitir ou não permitir o suporte de bloqueio geo país no serviço
Fonte AutoDJ Recodificar Sim
Não
ICES 0.4 SOMENTE
Insira apenas um dos valores na coluna de opções. Isso também pode conter “kbps” no final do valor da opção.
Especifique um valor incluindo MB, GB ou TB. Por exemplo: 100MB
Especifique um valor incluindo MB, GB ou TB. Por exemplo: 100MB
Históricos Relatórios
Relatórios Avançados
Sim/Não Habilitado ou desabilitar recursos de relatório histórico. A guia uso padrão será exibida em ambos os casos.
fluxo Autenticação de Autenticação
de ouvinte Autenticação
Autenticação Sim / Não Serviços Icecast e Icecast KH SOMENTE
Habilita ou desabilita o recurso de autenticação de fluxo de ouvinte.

Opções de publicação de fluxo (Wowza & Flussonic)

Destinos de fluxo

de

Opção configurável

Alternativas

Opções

Descrição

de publicação fluxo Sim / Não Habilita todos os destinos de fluxo
Publicação no Facebook Sim / Não
Youtube Publishing Sim / Não
Publicação do Periscope Sim / Não
Twitch Publishing Sim / Não
Shoutcast Publicação Sim / Não
Icecast Publishing Sim / Não
Publicação RTMP Sim / Não

Wowza motor de streaming

das opções de

Service

Live Streaming Live Streaming

Autenticação ao vivo – Simnão Wowza streaming Engine apenas.

nDVR

Perfis do

do transcodificador 160p

delimitada de perfis

Passthru

RTMPRTMP SupportRTMP ServiceYesNoEnable RTMP/RTSP links for Shoutcast & Icecast Services ONLY.
Descrição opções configuráveis
Wowza Media Type Tipo
de Serviço Flash Media Service
Low Latency
TV Station
Ondemand Streaming

Shoutcast / Icecast Relay
Live Camera Restream

nDVR AddOn nDVR
Reprodução
Sim
Não
Wowza Streaming Engine APENAS.
transcodificador Perfis 240p 360p 480p 576p 720p 1080p 2160p

Lista

do transcodificador Comma.
Disponível com MediaCP 2.6+Por exemplo:
240p 360p, 576p 240p, 360p, 480p 480p, 750p, 1080p

Gravação de Transmissão Live Stream Gravação Sim Não Wowza Streaming Engine APENAS.

Flussonic Media Server

Service TypeService TypeLive StreamingTV StationOndemand Streaming Perfis

160p

Opção configurável

Alternativas

Opções

Descrição

do transcodificador Perfis do transcodificador 240p 360p 480p 576p 720p 1080p 2160p

Passthru

Comma delimited list of transcoder profiles.

Available with MediaCP 2.6+

Por exemplo:
240P
360p,576p
240p,360p,480p
480p,750p,1080p

nDVR AddOn nDVR Sim / Não

Campos personalizados

Os campos personalizados permitem que os clientes insisem valores de texto específicos para algumas configurações.

de

/

Nome do campo Tipo campo Descrição de validação
Caixa de texto Publicar Nome ^[a-zd_]{4,28}$/i Disponível para todos os tipos de serviço de mídia.
O cliente pode especificar o nome de publicação desejado. Se não estiver disponível, o nome será atualizado automaticamente.
Verifique o campo obrigatório e apresente no formulário de pedido.
Shoutcast URL Text Box-WOWZA SERVICES ONLY.
O cliente pode especificar o URL de Restream do Shoutcast ou o URL do IPCAM Restream.
Nomes de campos alternativos podem ser:
Icecast URL Restream Address IPCAM URL

IPCAM Address

Wowza VHost Drop Down-WOWZA SERVIÇOS APENAS.
Somente administrador.
Campo obrigatório.
Formato:VHOST:IP:RTMP_PORT:Exemplo:_defaultVHost_:110.110.110.1:

1935

Permitir que o cliente especifique o nome de publicação

Você pode permitir que o cliente especifique seu nome de publicação preferencial seguindo estas etapas.

  1. Navegue até Setup-Products>/Services. Em seguida, selecione um produto MediaCP existente.
  2. Selecione a guia Campos Personalizados e Adicionar Novo Campo Personalizado com as configurações a seguir.
    • Nome do campo -nome de publicação
    • Tipo de campo -caixa de texto
    • Validação: /^[a-zd_]{4,28}$/i
    • Verificar Campo Obrigatório
    • Verificar Mostrar no Formulário de Encomenda

whmcs_custom_field

Modelos de e-mail

Streaming de áudio (Shoutcast / Icecast)

Você pode usar os seguintes modelos de email para vários serviços.

SERVIÇOS SHOUTCAST/ICECAST

POR FAVOR, LEIA ESTE E-MAIL NA ÍNTEGRA E IMPRIMI-LO PARA SEUS REGISTROS

Dear {$client _ Name},

Obrigado por sua ordem de nós!

Seu serviço shoutcast já foi criado e este e-mail contém todas as informações que você precisa para começar a usar seus serviços.

Painel de controle de hospedagem
Endereço: https://{$service_server_hostname}:2020/
Nome de usuário: {$service _ username}
Senha: {$service _ password}

Informações sobre o serviço de mídia
Endereço do serviço: {$mediacp_host_address}
Porta de serviço: {$mediacp_portbase}
Nome de usuário de streaming: DJ
Senha de streaming: {$service _ password}

Endereço administrador http://{$service _ Domain}/admin
Nome de usuário: admin
Senha: {$service _ password}

{foreach from=$service_config_options item=data} {$data.option}: {$data.value}
{/foreach}

Como transmitir para o seu novo serviço
1. Baixe e instale o Winamp a partir do www.winamp.com
2. Baixe e instale o Winamp Shoutcast DSP Plugin do http://shoutcast.com/BroadcastNow
3. Digite seu IP de serviço, porta e senha no plug-in DSP do Shoutcast e pressione conectar.

Obrigado por nos escolher.

{$signature}

Streaming de vídeo

Observe que esse modelo pressupõe que você configurou o campo personalizado “publicar nome” como o primeiro campo personalizado.

POR FAVOR, LEIA ESTE E-MAIL NA ÍNTEGRA E IMPRIMI-LO PARA SEUS REGISTROS

Dear {$client _ Name},

Obrigado por sua ordem de nós!

Seu serviço de mídia já foi criado e este e-mail contém todas as informações que você precisa para começar a usar seus serviços.

Painel de controle de hospedagem
Endereço: https://{$service_server_hostname}:2020/
Nome de usuário: {$service _ username}
Senha: {$service _ password}

Informações sobre o serviço de mídia
RTMP: rtmp://{$service_server_hostname}/{$service_custom_fields.0}/{$service_custom_fields.0}
RTSP: rtsp://{$service_server_hostname}/{$service_custom_fields.0}/{$service_custom_fields.0}

{foreach from=$service_config_options item=data} {$data.option}: {$data.value}
{/foreach}

Configuração do Codificador ao Vivo
URL do servidor: rtmp://{$service_server_hostname}/{$service_custom_fields.0}
Chave de fluxo: {$service_custom_fields.0}
Nome de usuário: {$service _ Custom_Fields. 0}
Senha: {$service _ password}

Obrigado por nos escolher.

{$signature}

Solucionando problemas

Falha na solicitação – Verifique se a porta de saída do firewall está aberta e se o domínio pode ser resolvido.

O motivo mais comum para esse erro é que o seu servidor WHMCS não consegue se comunicar com o MediaCP devido à porta de saída 2020 estar bloqueada do seu servidor WHMCS.

Recomendamos que você siga as etapas abaixo:

  1. Verifique se o MediaCP está atualizado com a versão mais recente para garantir a compatibilidade.
  2. Verifique se o Hostname, Port & SSL Mode do servidor WHMCS corresponde exatamente à sua instalação do MediaCP
  3. Verifique se a porta de firewall OUTBOUND 2020 está no servidor WHMCS ou entre em contato com seu provedor de hospedagem para concluir isso.
  4. Teste a conexão da API MediaCP usando nosso utilitário de teste on-line. Se o teste da API for bem-sucedido, o problema está no firewall do servidor WHMCS. Se o teste da API não for bem-sucedido, entre em contato conosco com as informações de saída para obter mais soluções de problemas.

Erro de transporte – não foi possível abrir o soquete

Há um problema de conexão entre o servidor WHMCS e o MediaCP. Siga o guia de solução de problemas acima.

Não suportado com a sua versão do MediaCP. Atualize o MediaCP para a versão 2.9.11, 2.10.7 ou mais recente.

Se você estiver vendo esse erro ao usar o botão Sincronizar dentro do WHMCS, isso significa:

  1. O seu MediaCP não está atualizado; ou
  2. Se o MediaCP estiver atualizado, isso também pode significar que a porta de saída 2000 ou 2020 está sendo bloqueada pelo seu firewall no servidor WHMCS. Certifique-se de que esta porta está aberta e tente novamente.

Importação de contas MediaCP para o WHMCS

O MediaCP 2.9.11 e 2.10.7 introduzem a capacidade de usar a ferramenta WHMCS Server Sync.

  1. Faça o login no WHMCS e navegue até a página Servidores
  2. Pressione o botão Sincronizar contas
  3. Selecione as contas que você deseja sincronizar e pressione Continuar
  4. Agora você deve atualizar o “Produto/Serviço” de cada serviço recém-criado no WHMCS.

Anotações:

  • As contas são correspondidas por campos de domínio e nome de usuário (e-mail)
  • Todas as contas recém-criadas serão colocadas em um pacote WHMCS chamado “default”, após a sincronização você deve abrir o serviço e alternar o Produto/Serviço para um pacote válido.

Table of Contents