IPS_CreateMedia

 int IPS_CreateMedia (int $MedienTyp) 

Parameterliste

Rückgabewert

ID des neu erstellten Medienobjekts

Beschreibung

Die Funktion legt ein leeres Medienobjekt vom Typ MedienTyp an.

Die Funktion liefert eine ID, mit deren Hilfe das erzeugte Medienobjekt eindeutig identifiziert werden kann. Das erzeugte Objekt ist nach dem Anlegen noch leer und muss mit der Funktion IPS_SetMediaFile noch mit einer realen Mediendatei verbunden werden.

Beispiel

// Anlegen eines neuen Medienobjekts mit dem Namen "Alarm"
$ImageFile = "media/Alarmsymbol.png";         // Image-Datei (relativ zum IP-Symcon Hauptordner)
$MediaID = IPS_CreateMedia(MEDIATYPE_IMAGE);                  // Image im MedienPool anlegen
IPS_SetMediaFile($MediaID, $ImageFile, true);   // Image im MedienPool mit Image-Datei verbinden
IPS_SetName($MediaID, "Alarm");                 // Medienobjekt benennen
IPS_SetParent($MediaID, 12345);                 // Medienobjekt einsortieren unter dem Objekt mit der ID "12345"