MediaCP Manual
Guida all’integrazione WHMCS

Last updated 2 mesi fa

visione f d’insieme

L’integrazione con WHMCS consente di impostare piani di servizio per vendere servizi di streaming audio e video con configurazione e provisioning automatici degli account dei clienti e dello streaming.

Note sulla versione del modulo

Changelog è disponibile su GitHub.

Modulo WHMCS

Installa il modulo più recente

1. Assicurati di avere l’ultima versione di MediaCP

2. Scarica l’ultima versione del modulo MediaCP per WHMCS

3. Estrarre il file .zip sul desktop

4. Connettiti al tuo server WHMCS tramite FTP e vai a [WHMCS]/modules/servers

5. Trascina e rilascia la cartella mediacp dal desktop al client FTP per caricare i file.

6. Ora dovresti vedere la cartella mediacp all’interno del tuo [WHMCS]percorso /modules/servers sul server ftp

Aggiunta di un server in WHMCS

  1. Accedi a WHMCS come amministratore e vai a
    Impostazioni di sistema.
  2. Seleziona Prodotti e servizi nelmenu a sinistra, quindi seleziona l’opzione Server .
  3. Seleziona il pulsante + Aggiungi nuovo server nella parte superiore della pagina e compila il modulo.
  4. Seleziona
    Vai alla modalità avanzata
  5. Compila il modulo secondo i dettagli qui sotto:
    • Nome – Immettere un’etichetta per questo server.
    • Nome host – Immettere il nome di dominio o sottodominio primario su cui è installato MediaCP, ad esempio streaming.myserver.com
    • Indirizzo IP – inserire l’indirizzo IP del server MediaCP, questo verrà utilizzato da WHMCS per convalidare l’accesso alle porte.
    • Indirizzo di stato del server – Viene utilizzato per fornire lo stato e il carico della rete a WHMCS. MediaCP fornisce un URL speciale da incollare nella configurazione del server WHMCS. Per visualizzare lo stato Online in WHMCS è necessario prima assicurarsi che MediaCP Port 80 sia abilitato.

      Il formato dell’indirizzo di stato WHMCS è descritto di seguito, sostituendo yourdomain.com:2020 con il nome host e la porta MediaCP e
      {api-key}
      con la chiave API MediaCP.

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

      Esempio:

      https://demo.mediacp.net/whmcs-status/iMtTpHvVWMjMh8dZgn6n0Vqoq3aWyomKmp-KjMV9W5uY06eepH2Mxg==/
    • Modulo – Pannello di controllo multimediale
    • Nome utente – Nome utente amministratore, il valore predefinito è “admin”
    • Parola d’ordine- Questo campo non viene utilizzato.
    • Hash di accesso – Fornisci la chiave API MediaCP in questo campo.
    • Sicuro : selezionare questa casella se HTTPS/SSL è configurato con MediaCP (ON predefinito).
    • Porta – La porta principale utilizzata dal software MediaCP. Il valore predefinito è 2020. Cambia solo se hai configurato una porta alternativa per MediaCP Web.
    • Name Server – queste informazioni non sono richieste dal modulo MediaCP.
  6. Premere il pulsante Salva modifiche per terminare.

Creazione del primo prodotto

Ora sei pronto per creare e configurare il tuo primo prodotto per MediaCP.

1. Passare a Configurazione -> Prodotti / Servizi. Quindi, fai clic su Crea un nuovo prodotto.

2. Selezionare Account di hosting condiviso e selezionare un gruppo di prodotti e un nome adatti e fare clic su Continua.

nuovo prodotto

3. Selezionare la scheda Impostazioni modulo e compilare le impostazioni di base come preferito.

whmcs_module_settings

4. Premere Salva modifiche

Addizionale

Opzioni configurabili

Puoi consentire ai tuoi clienti di creare i propri pacchetti impostando Opzioni configurabili.

  1. Passare a Setup-Prodotti/Servizi ->> Opzioni configurabili.
  2. Premere Crea un nuovo gruppo
  3. Configurare il nome del gruppo e i prodotti assegnati, quindi premere Aggiungi nuova opzione configurabile.
  4. Fare riferimento alla tabella seguente per creare le opzioni del pacchetto. È importante che le opzioni siano etichettate correttamente, è possibile scegliere di utilizzare l’opzione configurabile o le alternative per i nomi delle opzioni.

Media

Shoutcast 2 Shoutcast 198

Shoutcast Transcoder V1 Shoutcast Transcoder V2 Ices

Valore

dei

di

Proxy di flusso Proxy di flusso

Blocco geografico

del paese

Reencode

24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 400, 480, 560, 640, 720, 800, 920, 1024,

disco Quota

Report

Autenticazione del flusso

Opzioni configurabili Alternative Descrizione delle opzioni
Service-Shoutcast Icecast Icecast 2 Icecast 2

KH Icecast

KH

Wowza Streaming Engine
Flash Media Service
Servizi Windows Media

Fonte AutoDJ 0.4 (MP3)Ices 2.0 (OGG)

Stream Transcoder V3 In alternativa, è possibile impostare questo valore su “Sì” e il modulo configurerà automaticamente Shoutcast Transcoder V2
.

numerico punti montaggio Numero di punti di montaggio inclusi nel servizio Shoutcast o Icecast.
Deve essere un numero intero.
AutoDJ Sources Valore numerico Numero di sorgenti AutoDJ che possono essere applicate ai punti di montaggio sui servizi Shoutcast e Icecast.
Deve essere un numero intero.

No
Abilitare o disabilitare il proxy di flusso HTTP/HTTPS sull’account
Blocco Geolock
No
Consenti o non consenti il supporto del blocco del paese geografico sul servizio
Source AutoDJ Reencode Yes
No
ICES 0.4 ONLY
Connessioni Ascoltatori Visualizzatori Numero massimo utenti
Numero massimo
ascoltatori
Numero massimo di visualizzatori
Valore numerico Immettere un valore compreso tra 0 e 9999.
Bitrate massimo Bitrate 1280, 1536, 1792, 2048, 2560, 3072, 3584, 4096, 99999 Immettere solo uno dei valori nella colonna delle opzioni. Questo può anche contenere “Kbps” alla fine del valore dell’opzione.
Utilizzo disco
Quota
disco MB
, GB o TB Specificare un valore che includa MB, GB o TB. Ad esempio: 100 MB
Trasferimento dati Larghezza di banda di trasferimento MB, GB o TB Specificare un valore che includa MB, GB o TB. Ad esempio: 100 MB
cronologici Report avanzati Sì / No Abilitate o disabilitate le funzionalità di reporting cronologico. In entrambi i casi verrà visualizzata la scheda Utilizzo standard.
Autenticazione del flusso Autenticazione del listener Autenticazione del flusso Sì / No I servizi Icecast e Icecast KH SOLO abilita o disabilita la funzione di autenticazione del flusso del listener
.

Opzioni di pubblicazione in streaming (Wowza e Flussonic)

flusso

Youtube

RTMP

Opzioni configurabili Alternative Descrizione delle opzioni
Destinazioni flusso pubblicazione Sì/No Abilita tutte le destinazioni di flusso
Facebook Publishing Sì / No
Pubblicazione Sì / No
Periscope Publishing Sì / No
Twitch Publishing Sì / No
Shoutcast Publishing Sì / No
Icecast Publishing Sì / No
Pubblicazione Sì / No

Motore di streaming Wowza

Tipo

di

Live Streaming Live

nDVR

transcoder

160p

in streaming

RTMP Servizio RTMP

Opzioni configurabili Alternative Descrizione delle opzioni
di supporto Wowza Tipo servizio
Flash Media Service
Streaming
Stazione TV
a bassa latenza
Streaming ondemand Shoutcast
/ Icecast Relay
Live Camera Restream
Autenticazione live-Sì No Wowza Streaming Engine SOLO.
nDVR AddOn nDVR
Playback

No
Wowza Streaming Engine SOLO.
Profili Profili transcoder 240p 360p 480p 576p 720p 1080p 2160p

Passthru

Elenco delimitato da virgole dei profili transcodificatori.
Disponibile con MediaCP 2.6+Ad esempio:
240p 360p,576p 240p,360p,480p 480p,750p,1080p

Registrazione Registrazione in streaming live
No
Wowza Streaming Engine SOLO.
Supporto
No
Abilita i collegamenti RTMP/RTSP SOLO per i servizi Shoutcast e Icecast.

Server multimediale flussonico

Tipo di servizio

160p

Opzioni configurabili Alternative Descrizione delle opzioni
Tipo di servizio Live Streaming TV Station
Ondemand Streaming
Profili Transcoder Profili Transcoder 240p 360p 480p 576p 720p 1080p 2160p

Passthru

Elenco delimitato da virgole dei profili transcodificatori.

Disponibile con MediaCP 2.6+

Per esempio:
240p
360p, 576p
240p, 360p, 480p
480p, 750p, 1080p

nDVR AddOn nDVR Sì / No

Campi personalizzati

I campi personalizzati consentono ai clienti di immettere valori di testo specifici per alcune configurazioni.

campo Descrizione

Nome convalida tipo di campo
Casella di testo Nome pubblicazione / ^[a-zd_]{4,28}$/i Disponibile per tutti i tipi di servizi multimediali.
Il cliente può specificare il nome di pubblicazione desiderato. Se non disponibile, il nome verrà aggiornato automaticamente.
Controlla il campo obbligatorio e mostra sul modulo d’ordine.
Shoutcast URL Text Box-WOWZA SOLO SERVIZI.
Il cliente può specificare l’URL di Shoutcast Restream o l’URL di IPCAM Restream.
I nomi dei campi alternativi possono essere:
Icecast URL Restream Address
IPCAM URL

IPCAM Indirizzo IPCAM

Wowza VHost Drop Down-SOLO SERVIZI WOWZA.
Solo amministratore.
Campo obbligatorio.
Formato:VHOST:IP:RTMP_PORT:Esempio:_defaultVHost_:110.110.110.1:

1935

Consenti al cliente di specificare il nome di pubblicazione

È possibile consentire al cliente di specificare il proprio nome di pubblicazione preferito attenendosi alla seguente procedura.

  1. Passare a Setup-Prodotti>/Servizi. Quindi selezionare un prodotto MediaCP esistente.
  2. Selezionare la scheda Campi personalizzati e Aggiungi nuovo campo personalizzato con le seguenti impostazioni.
    • Nome campo -> Nome pubblicazione
    • Tipo di campo -> casella di testo
    • Validazione: /^[a-zd_]{4,28}$/i
    • Controlla campo obbligatorio
    • Controlla Mostra sul modulo d’ordine

whmcs_custom_field

Modelli di e-mail

Audio Streaming (Shoutcast / Icecast)

È possibile utilizzare i seguenti modelli di e-mail per vari servizi.

SERVIZI SHOUTCAST / ICECAST

SI PREGA DI LEGGERE QUESTA E-MAIL PER INTERO E STAMPARLA PER I VOSTRI RECORD

Caro {$client_nome},

Grazie per il tuo ordine da noi!

Il tuo servizio Shoutcast è stato creato e questa e-mail contiene tutte le informazioni di cui avrai bisogno per iniziare a utilizzare i tuoi servizi.

Pannello di controllo di hosting
Indirizzo: https://{$service_server_hostname}:2020/
Nome utente: {$service_nome_utente}
Password: {$service_password}

Informazioni sul servizio media
Indirizzo del servizio: {$mediacp_host_address}
Porta di servizio: {$mediacp_portbase}
Streaming Nome utente: dj
Password di streaming: {$service_password}

Indirizzo amministratore: http://{$service_dominio}/admin
Nome utente: admin
Password: {$service_password}

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

Come eseguire lo streaming sul nuovo servizio
1. Scarica e installa Winamp da www.winamp.com
2. Scarica e installa Winamp Shoutcast DSP Plugin da http://shoutcast.com/BroadcastNow
3. Inserisci il tuo IP di servizio, Porta e Password nel plug-in DSP Shoutcast, quindi premi Connetti.

Grazie per averci scelto.

{$signature}

Video Streaming

Si noti che questo modello presuppone che sia stato configurato il campo personalizzato “Nome pubblicazione” come primo campo personalizzato.

SI PREGA DI LEGGERE QUESTA E-MAIL PER INTERO E STAMPARLA PER I VOSTRI RECORD

Caro {$client_nome},

Grazie per il tuo ordine da noi!

Il tuo servizio multimediale è stato creato e questa e-mail contiene tutte le informazioni necessarie per iniziare a utilizzare i tuoi servizi.

Pannello di controllo di hosting
Indirizzo: https://{$service_server_hostname}:2020/
Nome utente: {$service_nome_utente}
Password: {$service_password}

Informazioni sul servizio media
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}

Configurazione Live Encoder
URL server: rtmp://{$service_server_hostname}/{$service_custom_fields.0}
Chiave di flusso: {$service_custom_fields.0}
Nome utente: {$service_custom_fields.0}
Password: {$service_password}

Grazie per averci scelto.

{$signature}

Risoluzione dei problemi

Richiesta non riuscita: assicurarsi che la porta in uscita del firewall sia aperta e assicurarsi che il dominio possa essere risolto.

Il motivo più comune per questo errore è che il server WHMCS non è in grado di comunicare con MediaCP a causa del blocco della porta in uscita 2020 dal server WHMCS.

Ti consigliamo di seguire i passaggi seguenti:

  1. Controlla che MediaCP sia aggiornato con la versione più recente per garantire la compatibilità.
  2. Verificare che il nome host, la porta e la modalità SSL del server WHMCS corrispondano esattamente all’installazione di MediaCP
  3. Controlla che la porta del firewall in uscita 2020 sia sul server WHMCS o contatta il tuo provider di hosting per completarlo.
  4. Testa la connessione API MediaCP utilizzando la nostra utility di test online. Se il test API ha esito positivo, il problema riguarda il firewall del server WHMCS. Se il test API non ha esito positivo, contattaci con le informazioni di output per ulteriori informazioni sulla risoluzione dei problemi.

Errore di trasporto – impossibile aprire il socket

Si è verificato un problema di connessione tra il server WHMCS e MediaCP. Si prega di seguire la guida alla risoluzione dei problemi sopra.

Non supportato con la versione di MediaCP in uso. Aggiornare MediaCP alla versione 2.9.11, 2.10.7 o successiva.

Se visualizzi questo errore quando usi il pulsante Sincronizza all’interno di WHMCS, significa che:

  1. Il tuo MediaCP non è aggiornato; o
  2. Se MediaCP è aggiornato, potrebbe anche significare che la porta in uscita 2000 o 2020 viene bloccata dal firewall sul server WHMCS. Assicurarsi che questa porta sia aperta e riprovare.

Importazione di account MediaCP in WHMCS

MediaCP 2.9.11 e 2.10.7 introducono la possibilità di utilizzare lo strumento di sincronizzazione del server WHMCS.

  1. Accedi a WHMCS e vai alla pagina Server
  2. Premi il pulsante Sincronizza account
  3. Seleziona gli account che desideri sincronizzare e premi Continua
  4. È ora necessario aggiornare il “Prodotto/Servizio” di ogni nuovo servizio creato in WHMCS.

Note:

  • Gli account corrispondono ai campi dominio e nome utente (email)
  • Tutti gli account appena creati verranno inseriti in un pacchetto WHMCS chiamato “default”, dopo la sincronizzazione è necessario aprire il servizio e passare il Prodotto / Servizio a un pacchetto valido.

Table of Contents