Manuale MediaCP
Documentazione API

Ultimo aggiornamento 8 anni fa

E’ possibile collegarsi ed eseguire varie funzioni da remoto con il pannello di controllo tramite PHP.

Ti verrà richiesto di scaricare e includere la libreria XML-RPC per PHP:
https://code.google.com/archive/p/php-ixr/

Sommario

  1. Funzioni di amministrazione
  2. Funzioni di servizio
  3. Funzioni di origine

 

Funzioni di amministrazione

admin.service_list

Elenca tutti i servizi MediaCP.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
nome utente Account utente da cui elencare i servizi.
.plugin NoService
shoutcast198
shoutcast2
Icecast
wowzaMedia
Flussonica
NginxRtmp
sourceplugin sapone liquido
ICES04
ICES20
sctransv1
sctransv2
StreamTransCoderV3
Specificare un’origine (autodj) da utilizzare con il servizio, se supportato.

Esempio PHP

  <?php
   require_once("../IXR_Library.php");

   $url = "https://demo.mediacp.net/";
   $command = "admin.service_list";
   $arguments = array(
   "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw=="
   )
   );

   $client = new IXR_ClientSSL($url. '/system/rpc.php');
   $client->debug = true; /** Set to true if you have difficulties **/

   if ( !$client->query( $command, $arguments) ) {
   die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage());
   }

   $return = $client->getResponse();

   if ( $return['status'] == 'success' ){
   echo $command. ' executed successfully.';
   }else{
   echo 'failed executing '. $command;
   }

   /** Output debugging information **/
   print_r( $return );

   ?>

admin.service_create

Crea un nuovo servizio di streaming multimediale collegato a un account cliente specifico.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
nome utente* Account utente su cui creare il servizio.
ID utente ALTERNATIVA a specificare il nome utente, specificare invece l’ID utente del cliente.
.plugin* NoService
shoutcast198
shoutcast2
Icecast
windowsMediaServices
wowzaMedia
Flussonica
sourceplugin ICES04
ICES20
sctransv1
sctransv2
StreamTransCoderV3
Specificare un’origine (autodj) da utilizzare con il servizio, se supportato.
unique_id * Stringa alfanumerica (non sono consentiti caratteri speciali) Nome di pubblicazione per identificare il servizio, ad esempio myShoutcastServer1
portbase NUMERO INTERO Specificare una porta su cui eseguire il servizio, altrimenti verrà determinato automaticamente.
rpc_extra BOOL (vero/falso) Se impostato su true, restituirà una matrice dell’intera configurazione del servizio creata.
maxuser INT (0-99999) Numero massimo di connessioni al servizio.
bitrate 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 Immettere solo uno dei valori nella colonna delle opzioni. Questo può anche contenere “Kbps” alla fine del valore dell’opzione.
larghezza di banda INT Trasferimento dati massimo al mese in MB, specificare 0 per nessun limite.
quota Allocazione massima di spazio su disco per il servizio (il valore predefinito è 30). Impostare su 0 per nessun limite.
Campi personalizzati ARRAY Specificare una matrice di opzioni di configurazione aggiuntive specifiche del servizio. È possibile identificare i parametri disponibili eseguendo una query su un servizio esistente utilizzando service.overview. Vedi sotto Esempio PHP per ulteriori informazioni.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "admin.service_create"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "username" => "admin", 
 "plugin" => "shoutcast198", 
 "sourceplugin" => "",
 "password" => "mypassword", 
 "maxuser" => "25", 
 "bitrate" => "48", 
 "bandwidth" => "10240", 
 "quota" => "1024", 
 "customfields" => array(
 "rtmpenabled" => "yes"
 )
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

admin.service_remove

Rimuove definitivamente un servizio multimediale dal pannello di controllo.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ServerID INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "admin.service_remove"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "serverid" => 10
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

admin.service_suspend

Sospende e arresta immediatamente un servizio multimediale specifico.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.
Ragione CORDA Il motivo della sospensione
Giorni INT Numero di giorni per sospendere il servizio o specificare “a tempo indeterminato” per la sospensione permanente.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "admin.service_suspend"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10, 
 "Reason" => "Failed to complete payment", 
 "Days" => 30
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

admin.service_unsuspend

Annulla la sospensione del servizio e tenta di riavviare il servizio multimediale.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.
<?php
 require_once("../IXR_Library.php");

 $url = "http://localhost/mediacp/";
 $command = "admin.service_unsuspend";
 $arguments = array(
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==",
 "ServerID" => 10,
 );

 $client = new IXR_Client($url. '/system/rpc.php');
 $client->debug = true; /** Set to true if you have difficulties **/

 if ( !$client->query( $command, $arguments) ) {
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage());
 }

 $return = $client->getResponse();

 if ( $return['status'] == 'success' ){
 echo $command. ' executed successfully.';
 }else{
 echo 'failed executing '. $command;
 }

 /** Output debugging information **/
 print_r( $return );

?>

admin.service_update

Aggiorna la configurazione di un servizio multimediale specifico.

La tabella seguente fornisce un elenco minimo delle configurazioni disponibili, è possibile specificare e aggiornare qualsiasi parametro restituito da service.overview per il servizio specifico, notando che ogni servizio multimediale (Shoutcast, Icecast, Wowza ecc.) ha diverse configurazioni disponibili.

Ti consigliamo di non modificare i seguenti valori in quanto potrebbero causare problemi con il tuo servizio: plugin, sourceplugin, servicetype, portbase.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ServerID * INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.
nome utente Account utente su cui creare il servizio.
ID utente ALTERNATIVA a specificare il nome utente, specificare invece l’ID utente del cliente.
maxuser INT (0-99999) Numero massimo di connessioni al servizio.
bitrate 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 Immettere solo uno dei valori nella colonna delle opzioni. Questo può anche contenere “Kbps” alla fine del valore dell’opzione.
larghezza di banda INT Trasferimento dati massimo al mese in MB, specificare 0 per nessun limite.
quota Allocazione massima di spazio su disco per il servizio (il valore predefinito è 30). Impostare su 0 per nessun limite.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "admin.service_update"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "serverid" => 10, 
 
 "password" => "mypassword", 
 "maxuser" => "25", 
 "bitrate" => "48", 
 "bandwidth" => "10240", 
 "quota" => "1024"
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

admin.user_create

Crea un nuovo account cliente all’interno del pannello di controllo.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
nome utente ALFANUMERICO Sono consentiti anche alcuni caratteri speciali come un punto, un carattere di sottolineatura e un simbolo at.
Hash Una combinazione hash SHA1 del nome utente e della password. Ad esempio: SHA1( ï¿1/2usernameï¿1/2 . ï¿1/2passwordï¿1/2 )
user_level 0 Cliente
2 Super amministratore
nome ALFANUMERICO Nome e cognome dei clienti
reseller_plan NUMERO INTERO Specificare l’ID del piano rivenditore se si desidera assegnare l’account come rivenditore
attivante 0 o 1
tema Specificare un tema da utilizzare per questo account, altrimenti verrà utilizzato il valore predefinito.
Lingua Specificare una lingua da utilizzare per questo account, altrimenti verrà utilizzata l’impostazione predefinita.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "admin.user_create"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "username" => "[email protected]", 
 "hash" => SHA1("[email protected]" . "mypassword"), 
 "user_level" => 0,
 "name" => "My Customer", 
 "activated" => 1, 
 "reseller_plan" => 1,
 "theme" => "Experience", 
 "language" => "english"
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

admin.user_update

Aggiorna un account cliente specifico.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
nome utente* Specificare l’account utente che si desidera aggiornare
ID utente ALTERNATIVA al nome utente, specificare l’ID cliente.
Hash Una combinazione hash SHA1 del nome utente e della password. Ad esempio: SHA1( ï¿1/2usernameï¿1/2 . ï¿1/2passwordï¿1/2 )
user_level 0 Cliente
2 Super amministratore
nome ALFANUMERICO Nome e cognome dei clienti
attivante 0 o 1
tema Specificare un tema da utilizzare per questo account, altrimenti verrà utilizzato il valore predefinito.
Lingua Specificare una lingua da utilizzare per questo account, altrimenti verrà utilizzata l’impostazione predefinita.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "admin.user_update"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "username" => "[email protected]", 
 "hash" => SHA1("[email protected]" . "mynewpassword"), 
 "user_level" => 0,
 "name" => "My Customer", 
 "activated" => 1, 
 "reseller_plan" => 1,
 "theme" => "Experience", 
 "language" => "english"
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

admin.user_remove

Rimuove un account cliente specifico.

NOTA: tutti i servizi multimediali con l’account DEVONO essere rimossi prima che l’account cliente possa essere rimosso.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
nome utente* Specificare l’account utente che si desidera aggiornare
ID utente ALTERNATIVA al nome utente, specificare l’ID cliente.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "admin.user_remove"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "username" => "[email protected]", 
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

Funzioni di servizio

service.overview

Genera una matrice dell’intera configurazione del servizio.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server * INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.overview"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

service.status

Restituisce lo stato del servizio con una delle risposte seguenti.

  • non riuscito – Impossibile cercare il servizio
  • offline – Il servizio è offline.
  • online – Il servizio è online
  • sospeso – Il servizio è sospeso
  • scaduto – Il servizio è scaduto
  • non collegabile – Il servizio non è raggiungibile

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ServerID INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.status"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "serverid" => 10
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

service.start

Avvia un servizio multimediale specifico.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.start"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

service.stop

Arresta un servizio multimediale specifico.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.stop"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

servizio.riavvio

Riavvia un servizio multimediale specifico.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.restart"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

service.updatetitle

Aggiorna il titolo In riproduzione di un live streaming.

Compatibile solo con Shoutcast 198, Shoutcast 2, Icecast 2 e Icecast KH.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.
unique_id INT ALTERNATIVA a serverid, specificare il unique_id del servizio da rimuovere.
NewTitle STRINGA (250 caratteri) Testo per sostituire il titolo corrente In riproduzione di un live streaming.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.updatetitle"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10,
 "NewTitle" => "This control panel is the greatest"
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

service.kicksource

Calcia la sorgente attiva in un live streaming.

Compatibile solo con Shoutcast 198, Shoutcast 2, Icecast 2 e Icecast KH.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.kicksource"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

service.wowza_alias

Gestisci gli alias di streaming di un servizio di motore di streaming Wowza.

Compatibile solo con i servizi Wowza Streaming Engine.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.
azione creare
togliere
Azione da eseguire con l’alias specificato
alias STRINGA (50 caratteri) Nome del flusso di alias che è possibile visualizzare. rtmp://myserver/myapplication/ myalias
nome STRINGA (50 caratteri) Flusso di origine effettivo che verrà visualizzato. Valore predefinito ${Stream.Name}

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.wowza_alias"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10,
 "alias" => "myalias",
 "name" => "${Stream.Name}"
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

service.wowza_tvschedule

Restituisci un elenco di playlist programmate da un servizio Wowza TV Station.

Compatibile solo con i servizi Wowza Streaming Engine.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server * INT ID servizio da arrestare e rimuovere dal pannello di controllo.
date_start Formato del campo data/ora MySQL AAAA-MM-GG HH:MM:GG
date_end Formato del campo data/ora MySQL AAAA-MM-GG HH:MM:GG

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.wowza_alias"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10,
 "date_start" => "2015-01-01 00:00:00",
 "date_end" => "2015-01-01 23:00:00"
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

service.wowza_tvschedule_playlist

Restituisce una matrice di file pianificati in una playlist specifica di TV Station.

Compatibile solo con i servizi Wowza Streaming Engine.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server * INT ID servizio da arrestare e rimuovere dal pannello di controllo.
playlist_id INT ID playlist che desideri recuperare.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "service.wowza_alias"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10,
 "playlist_id" => "1"
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

Funzioni di origine

source.list_playlists

Restituisce una matrice di playlist disponibili create con l’account cliente.

Compatibile solo con Shoutcast 198, Shoutcast 2, Icecast 2 e Icecast KH.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "source.list_playlists"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

source.status

Restituisce lo stato dell’origine (AutoDJ).

Compatibile solo con Shoutcast 198, Shoutcast 2, Icecast 2 e Icecast KH.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "source.status"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10 
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

source.restart

Riavvia il plug-in di origine associato a un servizio specifico utilizzando l’ultima playlist riprodotta.

Compatibile solo con Shoutcast 198, Shoutcast 2, Icecast 2 e Icecast KH.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "source.restart"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10 
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

source.start

Avvia il plug-in di origine associato a un servizio specifico utilizzando l’ultima playlist riprodotta.

Compatibile solo con Shoutcast 198, Shoutcast 2, Icecast 2 e Icecast KH.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "source.start"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10 
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

source.stop

Arresta il plug-in di origine associato a un servizio specifico.

Compatibile solo con Shoutcast 198, Shoutcast 2, Icecast 2 e Icecast KH.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server INT ID servizio da arrestare e rimuovere dal pannello di controllo.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "source.stop"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10 
 );  
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

source.schedule

Pianifica il passaggio a una playlist specificata all’ora designata.

Compatibile solo con Shoutcast 198, Shoutcast 2, Icecast 2 e Icecast KH.

Limitato a 50 pianificazioni per servizio multimediale.

Parametri

Parametro Opzioni Descrizione
Auth* Chiave API per l’autenticazione al pannello di controllo.
ID server NUMERO INTERO ID servizio da arrestare e rimuovere dal pannello di controllo.
playlist TESTO Specificare una playlist da programmare.
year NUMERO INTERO Specificare l’anno completo, ad esempio 2015 o 0 per il valore ricorrente.
month NUMERO INTERO Specificare il valore numerico del mese, ad esempio 01 è gennaio o 0 per il valore ricorrente.
giorno NUMERO INTERO Specificare il valore numerico del giorno, ad esempio 01 sarebbe il 1° del mese o specificare 0 per il valore ricorrente.
ora Specificare il valore numerico dell’ora nel formato 24 ore, ad esempio 16 equivarrebbe a 4PM o specificare 0 per il valore ricorrente.
minuto Specificare il valore numerico del minuto.

Esempio PHP

<?php
 require_once("../IXR_Library.php"); 
 
 $url = "http://localhost/mediacp/";
 $command = "source.schedule"; 
 $arguments = array( 
 "auth" => "VJhZdqjUWpigishesXamoVSp33WZmoxWoZ-7XJysWs6coKyd0K2Glw==", 
 "ServerID" => 10,
 "playlist" => "myplaylist",
 "year" => "2015",
 "month" => "0",
 "day" => "1",
 "hour" => "09",
 "minute" => "00"
 ); 
 
 $client = new IXR_Client($url. '/system/rpc.php'); 
 $client->debug = true; /** Set to true if you have difficulties **/ 
 
 if ( !$client->query( $command, $arguments) ) { 
 die('An error occurred - '.$client->getErrorCode().":".$client->getErrorMessage()); 
 } 
 
 $return = $client->getResponse(); 
 
 if ( $return['status'] == 'success' ){ 
 echo $command. ' executed successfully.'; 
 }else{ 
 echo 'failed executing '. $command; 
 } 
 
 /** Output debugging information **/ 
 print_r( $return ); 
 
?>

Table of Contents