Allgemein

Die APIist, wenn sie aktiviert ist, unter "http://localhost:8989/api/v1" verfügbar. Dies ist die Basis URL die jeder Methode vorangestellt werden muss URL unten aufgeführt.

Wurde eine Ressource nach dem ursprünglichen Start des HTTP APIwird die Methode mit einem Verfügbar seit Informationen.

/

Unterstützte Methoden: "GET"
Leitet zur Liste der offenen Dokumente unter "/documents" weiter.

/Geräte

Unterstützte Methoden: "GET"
Gibt eine Liste der aktuell verfügbaren Videogeräte auf dem Hostsystem zurück. Jeder Eintrag enthält eine Kennung und einen von Menschen lesbaren Namen. Nützlich für die Zuordnung von Aufnahmegeräten zu Quellen.

/Geräte/(GeräteID)

Unterstützte Methoden: "GET"
Gibt Details zu dem durch "(DeviceID)" angegebenen Gerät zurück, einschließlich seines Namens und seiner Eigenschaften.

Dokumente

Abfrage von Dokumenten

/Dokumente

Unterstützte Methoden: "GET"
Ergibt eine Liste der geöffneten Dokumente. Welche Informationen die zurückgegebenen Objekte enthalten, entnehmen Sie bitte dem Datentyp Dokumente.

/Dokumente/(DokumentID)

Unterstützte Methoden: "GET"
Gibt ein einzelnes, durch die "(DocumentID)" spezifiziertes Dokument zurück. Im eingeschlossenen Teil der Antwort werden alle von diesem Dokument verwendeten "Layer"-Objekte und alle in diesem Dokument enthaltenen "Source"-Objekte ebenfalls zurückgegeben (Sideloading). Weitere Informationen zu den zurückgegebenen Daten finden Sie unter dem Datentyp des Dokuments.

/Dokumente/(DocumentID)/ProgrammAus

Unterstützte Methoden: "GET"
Die Programmausgabe, die derzeit von dem durch "(DocumentID)" angegebenen Dokument erzeugt wird.
Nimmt die gleichen Parameter wie die Quellvorschau an.

Dokument-Aktionen

/Dokumente/(DocumentID)/setLive

Unterstützte Methoden: "GET" "POST"
Startet eine Show/ein Dokument und löst alle zugehörigen Ereignisse aus. Der Aufruf dieses Befehls bei einem bereits laufenden Dokument führt nicht zu einem Fehler. Es wird das aktualisierte Dokumentobjekt zurückgegeben.

/Dokumente/(DocumentID)/setOff

Unterstützte Methoden: "GET" "POST"
Hält eine Sendung/ein Dokument an. Der Aufruf dieser Funktion bei einer bereits gestoppten Show führt nicht zu einem Fehler. Es wird das aktualisierte Dokumentobjekt zurückgegeben.

Da ein Dokument nach dem Aufruf dieser Methode weiterlaufen kann, befindet sich das zurückgegebene Ebenenobjekt möglicherweise im Zustand "shutdown" statt "off".

/Dokumente/(DocumentID)/UmschaltenLive

Unterstützte Methoden: "GET" "POST"
Schaltet eine Sendung/ein Dokument zwischen Live und Aus um.

Schichten

Ebenen abfragen

/Dokumente/(DocumentID)/Schichten

Unterstützte Methoden: "GET"
Gibt eine Liste von Ebenen für das durch "(DocumentID)" angegebene Dokument zurück. Informationen zu den zurückgegebenen Objekten finden Sie unter dem Datentyp layers.

/Dokumente/(DokumentID)/Schichten/(SchichtID)

Unterstützte Methoden: "GET", "PUT"
Gibt eine einzelne durch "(LayerID)" spezifizierte Ebene in dem durch "(DocumentID)" spezifizierten Dokument zurück. Im Abschnitt "included" der Antwort werden auch alle mit dieser Ebene verbundenen "variant"-Objekte zurückgegeben (sideloading). Weitere Informationen zu den zurückgegebenen Daten finden Sie im Datentyp der Ebene. Bitte beachten Sie, dass die "input-values" des Layer-Endpunkts die "input-values" der zugehörigen "liveVariant"-Variante widerspiegeln.

Ändern einer Ebene

Unterstützte Methoden: "GET", "PUT"
Um den Namen der Ebene, die Audiolautstärke oder die Eingabewerte festzulegen, führen Sie einen "PUT" Anfrage mit einer JSON kodiertes Objekt an den Endpunkt der Ebene. Alternativ können Sie auch ein "GET"Anfrage durch Hinzufügen der JSON Daten an den URL mit dem Schlüssel "?update=". In diesem Fall wird die JSON müssen die Daten URL verschlüsselt.

Werte, die Sie nicht ändern wollen, sollten Sie einfach aus der JSON Daten. Beispiel:

{
    "name": "New name of the Layer",
    "volume": 0.5,
    "input-values": { 
        "tvGroup_Content__Subtitle": "This is a Test"
    }
}

Nach der Aktualisierung der Werte wird mimoLive mit einem aktualisierten Ebenenobjekt reagieren. Beachten Sie, dass nicht alle Werte sofort angewendet werden können oder sich erst nach einem weiteren Rendering-Zyklus auswirken können.

Hinweis: Das Attribut "Lautstärke" wurde in mimoLive 5.6 hinzugefügt und wird in früheren Versionen ignoriert oder wenn die Ebene keine Lautstärkeregelung hat. Der Wert wird auf (0, 1) beschnitten, wobei 0 für Stille und 1 für volle Lautstärke steht.

Ebenen-Aktionen

/Dokumente/(DocumentID)/Layer/(LayerID)/setLive

Unterstützte Methoden: "GET" "POST"
Aktiviert eine Ebene, wenn dies direkt auf der Ebene aufgerufen wird, wird die zuletzt ausgewählte Ebenenvariante verwendet. Der Aufruf dieser Funktion auf einer bereits aktiven Ebene führt nicht zu einem Fehler. Es wird das aktualisierte Ebenenobjekt zurückgegeben.

/Dokumente/(DocumentID)/Layer/(LayerID)/setOff

Unterstützte Methoden: "GET" "POST"
Deaktiviert eine Ebene. Der Aufruf dieser Funktion bei einer bereits deaktivierten Ebene führt nicht zu einem Fehler. Es wird das aktualisierte Ebenenobjekt zurückgegeben.

Da eine Ebene nach dem Aufruf dieser Methode beschließen kann, einige Animationen durchzuführen, kann das zurückgegebene Ebenenobjekt im Zustand "shutdown" statt "off" sein.

/Dokumente/(DokumentID)/Ebenen/(EbenenID)/UmschaltenLive

Unterstützte Methoden: "GET" "POST"
Schaltet eine Ebene zwischen "live" und "aus" um.

/Dokumente/(DocumentID)/Schichten/(LayerID)/Signale/(SignalID)

Unterstützte Methoden: "GET" "POST"
Löst das durch "(SignalID)" angegebene Signal in der aktuellen "Live-Variante" oder, wenn die Ebene nicht live ist, in der "Aktiv-Variante" aus. Die "(SignalID)" können Sie dem Feld "input-values" der Ebene entnehmen (gekennzeichnet durch das Schlüsselsuffix "_TypeSignal").

/documents/(DocumentID)/layers/(LayerID)/cycleThroughVariants

Unterstützte Methoden: "GET" "POST"
Verfügbar seit: mimoLive 5.6
Wählt die nächste Variante nach der derzeit aktiven Variante des Layers "(LayerID)" als neue aktive Variante des Layers aus. Dies kann verwendet werden, um die Variante (z. B. eines Lower Third-Layers) auszuwählen, die aktiv werden soll nächste.
Wenn Sie diesen Endpunkt aufrufen, wird Ihre Show nicht gestört, wenn die Ebene gerade live ist. Der Effekt wird nur angezeigt, wenn die Ebene anschließend live geschaltet wird.

/documents/(DocumentID)/layers/(LayerID)/cycleThroughVariantsBackwards

Unterstützte Methoden: "GET" "POST"
Wählt die vorherige Variante aus (die Umkehrung von /cycleThroughVariants), ohne den aktuellen Live-Status zu beeinflussen. Der Effekt wird sichtbar, wenn die Ebene oder die ausgewählte Variante live geschaltet wird.

/documents/(DocumentID)/layers/(LayerID)/setLiveFirstVariant

Unterstützte Methoden: "GET" "POST"
Aktiviert die erste Variante der Ebene und setzt die Ebene live.

/documents/(DocumentID)/layers/(LayerID)/setLiveLastVariant

Unterstützte Methoden: "GET" "POST"
Aktiviert die letzte Variante der Ebene und setzt die Ebene live.

/documents/(DocumentID)/layers/(LayerID)/inputs/(SourceInputKey)/mediacontrol/(MediaControlCommand)

Unterstützte Methoden: "GET" "POST"
Sendet einen Mediensteuerungsbefehl an das Medium, das an den Eingang "(SourceInputKey)" der angegebenen Ebene gebunden ist. Bitte beachten Sie, dass die Quelle der Eingabe meldet, welche Befehle sie unterstützt; siehe /documents/(DocumentID)/sources/(SourceID).

Befehl Mediensteuerung	Beschreibung
spielen	Startet die Medienwiedergabe.
Pause	Hält die aktuelle Wiedergabe an, ohne die Position zurückzusetzen.
stoppen	Stoppt die Wiedergabe und setzt die Medienposition an den Anfang zurück.
umkehren	Spielt Medien in umgekehrter Richtung ab.
Zurückspulen	Bewegt die Wiedergabe rückwärts, normalerweise schneller als normal.
vorspulen	Bewegt die Wiedergabe schnell vorwärts.
skiptostart	Springt an den Anfang der Medien.
skiptoend	Springt zum Ende der Medien.
Rücksprung	Springt in einem Intervall von 10 Sekunden rückwärts.
skipahead	Springt in einem Intervall von 10 Sekunden vorwärts.
aufnehmen	Startet die Aufnahme der Medieneingabe.
Shuffle	Schaltet die zufällige Wiedergabereihenfolge für Medienelemente um.
wiederholen	Wiederholen Sie die aktuellen Medien.

Varianten

Abfrage von Varianten

/Dokumente/(DocumentID)/Schichten/(LayerID)/Varianten

Unterstützte Methoden: "GET"
Gibt eine Liste von Varianten für den durch "(LayerID)" angegebenen Layer und das durch "(DocumentID)" angegebene Dokument zurück. Informationen zu den zurückgegebenen Objekten finden Sie im Datentyp "variants".

/Dokumente/(DocumentID)/Layer/(LayerID)/Varianten/(VariantID)

Unterstützte Methoden: "GET", "PUT"
Gibt eine einzelne Variante zurück, die durch "(VariantID)" und "(LayerID)" in dem durch "(DocumentID)" angegebenen Dokument angegeben ist. Weitere Informationen zu den zurückgegebenen Daten finden Sie unter dem Datentyp "variants".

Ändern einer Variante

Um den Namen der Variante oder der Eingabewerte festzulegen, führen Sie ein "PUT" Anfrage mit einer JSON kodiertes Objekt an den Variantenendpunkt. Werte, die Sie nicht ändern wollen, sollten Sie einfach aus dem JSON Sie "PUT". Beispiel:

{
    "name": "New name of the Variant",
    "input-values": { 
        "tvGroup_Content__Subtitle": "This is a Test"
    }
}

Nach dem Aktualisieren der Werte antwortet mimoLive mit einem aktualisierten Variantenobjekt. Beachten Sie, dass nicht alle Werte sofort angewendet werden können oder sich erst nach einem weiteren Rendering-Zyklus auswirken können.

Abweichende Aktionen

/Dokumente/(DocumentID)/Layer/(LayerID)/Varianten/(VariantID)/setLive

Unterstützte Methoden: "GET" "POST"
Aktiviert eine Variante, wenn die eigene Ebene nicht aktiv ist, wird sie ebenfalls aktiv geschaltet. Der Aufruf dieser Funktion bei einer bereits aktiven Variante führt nicht zu einem Fehler. Es wird das aktualisierte Variantenobjekt zurückgegeben.

/Dokumente/(DocumentID)/Layer/(LayerID)/Varianten/(VariantID)/setOff

Unterstützte Methoden: "GET" "POST"
Deaktiviert eine Variante. Dadurch wird auch die zugehörige Ebene ausgeschaltet.

/Dokumente/(DocumentID)/Ebenen/(LayerID)/Varianten/(VariantID)/toggleLive

Unterstützte Methoden: "GET" "POST"
Schaltet eine Variante zwischen live und off um.

/Dokumente/(DocumentID)/Layer/(LayerID)/Varianten/(VariantID)/Signale/(SignalID)

Unterstützte Methoden: "GET" "POST"
Löst das durch "(SignalID)" angegebene Signal auf der Variante aus. Die "(SignalID)" können Sie dem Feld "input-values" des Layers entnehmen (gekennzeichnet durch das Schlüsselsuffix "_TypeSignal").

Quellen

Quellen abfragen

/Dokumente/(DocumentID)/Quellen

Unterstützte Methoden: "GET"
Gibt eine Liste der Quellen für das durch "(DocumentID)" angegebene Dokument zurück. Informationen zu den zurückgegebenen Objekten finden Sie im Datentyp "Quellenebene".

/Dokumente/(DocumentID)/Quellen/(SourceID)

Unterstützte Methoden: "GET", "PUT"
Gibt eine einzelne durch "(SourceID)" angegebene Quelle in dem durch "(DocumentID)" angegebenen Dokument zurück. Im eingeschlossenen Teil der Antwort werden auch alle mit dieser Quelle verbundenen "Filter"-Objekte zurückgegeben (Sideloading). Weitere Informationen zu den zurückgegebenen Daten finden Sie unter dem Datentyp "Quellen".

/Dokumente/(DocumentID)/Quellen/(SourceID)/Vorschau

Unterstützte Methoden: "GET"
Gibt eine grafische Vorschau der durch "(SourceID)" angegebenen Quelle in dem durch "(DocumentID)" angegebenen Dokument zurück. Der Endpunkt unterstützt die folgenden Parameter:

Parameter	Standard	Beschreibung
Format	png	Das Format, in dem die Vorschau zurückgegeben wird. Erlaubte Werte: png, jpeg, mjpeg, mpng
fps	10	Die Framerate für die Vorschau von Bewegtbildern. Gilt nur für die Formate mjpeg und mpng. Bitte beachten Sie, dass 1 fps ungefähr 1% von CPU Nutzung.
Breite	(Dokumentbreite)	Die maximale Breite der Vorschau. Das Bild wird verkleinert, damit es in die angegebene Breite passt.
Höhe	(Dokumentbreite)	Die maximale Höhe der Vorschau. Das Bild wird verkleinert, damit es in die angegebene Höhe passt.

/Dokumente/(DocumentID)/Quellen/(SourceID)/mediacontrol/(MediaControlCommand)

Unterstützte Methoden: "GET" "POST"
Steuert die Wiedergabe für medienfähige Quellen (z.B. Mediendatei/Playlist). Die unterstützten Befehle hängen vom Typ der Quelle ab. Siehe /documents/(DocumentID)/layers/(LayerID)/inputs/(SourceInputKey)/mediacontrol/(MediaControlCommand) .

/documents/(DocumentID)/sources/(SourceID)/openwebbrowser

Unterstützte Methoden: "GET"
Falls es sich bei der Quelle um eine Web Browser Capture-Quelle handelt, wird diese Aktion das entsprechende Web Browser-Fenster öffnen.

Ändern einer Quelle

Um den Namen der Quelle oder der Eingabewerte festzulegen (nur wenn die Quelle welche hat, z. B. wenn es sich um eine Kompositionsquelle handelt), führen Sie einen "PUT" Anfrage mit einer JSON kodierten Objekts an den Quellendpunkt. Werte, die Sie nicht ändern wollen, sollten Sie einfach aus dem JSON Sie "PUT". Beispiel:

{
    "name": "New name of the Source",
    "gain": 1.25,
    "input-values": { 
        "tvGroup_Content__Subtitle": "This is a Test"
    }
}

Das Attribut "gain" wurde in mimoLive 5.6 hinzugefügt und wird in früheren Versionen ignoriert oder wenn die Quelle keinen Gain-Regler hat. Der Wert wird auf (0, 2) beschnitten, wobei 0 stumm ist, 1 die Standardeinstellung und 2 ungefähr die doppelte Lautstärke.

Quelle: Aktionen

/Dokumente/(DocumentID)/Quellen/(SourceID)/Signale/(SignalID)

Unterstützte Methoden: "GET" "POST"
Löst das durch "(SignalID)" spezifizierte Signal an der Quelle aus (nur wenn die Quelle "input-values" hat, z. B. wenn es sich um eine Composition Source handelt). Die "(SignalID)" können Sie dem Feld "input-values" der Quelle entnehmen (gekennzeichnet durch das Schlüsselsuffix "_TypeSignal").

Filter

Abfrage von Filtern

/Dokumente/(DocumentID)/Quellen/(SourceID)/Filter

Unterstützte Methoden: "GET"
Gibt eine Liste von Filtern für die durch "(SourceID)" angegebene Quelle und das durch "(DocumentID)" angegebene Dokument zurück. Informationen zu den zurückgegebenen Objekten finden Sie im Datentyp "filters".

/Dokumente/(DocumentID)/Quellen/(SourceID)/Filter/(FilterID)

Unterstützte Methoden: "GET", "PUT"
Gibt einen einzelnen, durch "(FilterID)" und "(SourceID)" spezifizierten Filter in dem durch "(DocumentID)" angegebenen Dokument zurück. Weitere Informationen zu den zurückgegebenen Daten finden Sie unter dem Datentyp "filters".

Ändern eines Filters

Zum Einstellen der Eingabewerte führen Sie einen "PUT" Anfrage mit einer JSON kodiertes Objekt an den Filterendpunkt. Werte, die Sie nicht ändern wollen, sollten Sie einfach aus dem JSON Sie "PUT". Beispiel:

{
    "input-values": { 
        "tvGroup_Content__Subtitle": "This is a Test"
    }
}

/Dokumente/(DocumentID)/Quellen/(SourceID)/Filter/(FilterID)/Signale/(SignalID)

Unterstützte Methoden: "GET" "POST"
Löst das durch "(SignalID)" angegebene Signal im Filter aus. Die "(SignalID)" kann dem Feld "input-values" des Filters entnommen werden (gekennzeichnet durch den Schlüsselzusatz "_TypeSignal").

Ausgabeziele

Abfrage von Ausgabezielen

/documents/(DocumentID)/output-destinations

Unterstützte Methoden: "GET"
Listet alle Ausgabeziele für das angegebene Dokument auf.
Informationen zu den zurückgegebenen Objekten finden Sie im Datentyp "output-destinations": {TOPIC-LINK+data-typesh1(}. section-output-destinations).

/documents/(DocumentID)/output-destinations/(OutputDestinationID)

Unterstützte Methoden: "GET"
Gibt das durch "(OutputDestinationID)" angegebene Ausgabeziel zurück.
Informationen zu den zurückgegebenen Objekten finden Sie im Datentyp "output-destinations": {TOPIC-LINK+data-typesh1(}. section-output-destinations).

Ändern eines Ausgabeziels

/documents/(DocumentID)/output-destinations/(OutputDestinationID)

Unterstützte Methoden: "PUT", "PATCH"
Aktualisierung ausgewählter Eigenschaften des durch "(OutputDestinationID)" angegebenen Ausgabeziels.
Gibt das aktualisierte Ausgabeziel zurück.

Die folgenden Eigenschaften sind änderbar:

• "Titel"
• "beginnt-mit-Schau"
• "Stoppt-mit-Show"
• Inhalt des Objekts "Einstellungen" (siehe die Beschreibung der Einstellungen. section-individual-settings) für weitere Informationen)

Die Beschreibung der Aktualisierung muss in JSON:API-Aktualisierungsformat . crud-updating). Beispiel:

{
  "data": {
    "type": "output-destinations",
    "id": "4FF003EA-D071-43FD-845F-DCD4A25DFA00",
    "attributes": {
      "title": "Our Recording",
      "starts-with-show": true,
      "settings": {
        "location": "~/Movies"
      }
    }
  }
}

Ausgabeziel Aktionen

/documents/(DocumentID)/output-destinations/(OutputDestinationID)/setLive

Unterstützte Methoden: "GET" "POST"
Bewirkt, dass das durch "(OutputDestinationID)" angegebene Ausgabeziel live geschaltet wird, wenn es ordnungsgemäß konfiguriert ist und live geschaltet werden darf (z. B. auf der Grundlage des mimoLive-Lizenzierungsstatus).
Wenn das Ausgabeziel live gehen kann, wird das Ausgabeziel mit seinem neuen "Live-Status" zurückgegeben, andernfalls wird ein "409 Conflict"-Fehler zurückgegeben.

Da ein Ausgabeziel unter Umständen noch einige Arbeiten durchführen muss, bevor es live geschaltet wird (z. B. Kontaktaufnahme mit einem externen Dienst, um einen Live-Stream zu erstellen), kann sich das zurückgegebene Ausgabezielobjekt im Zustand "startup" statt "live" befinden.

/documents/(DocumentID)/output-destinations/(OutputDestinationID)/setOff

Unterstützte Methoden: "GET" "POST"
Bewirkt, dass das durch "(OutputDestinationID)" angegebene Ausgabeziel angehalten wird.
Wenn das Ausgabeziel anhalten darf, wird das Ausgabeziel zurückgegeben, andernfalls wird ein "409 Conflict"-Fehler zurückgegeben.

Da ein Ausgabeziel vor dem Beenden des Vorgangs möglicherweise noch einige Arbeiten durchführen muss, kann sich das zurückgegebene Ausgabeziel im Zustand "shutdown" statt "preview" befinden (was bei einem gut konfigurierten Ausgabeziel der Standardzustand wäre).

Ebenen-Sets

Ebenensets wurden in mimoLive 5.0 eingeführt und erlauben es, den Live-Status mehrerer Ebenen gleichzeitig zu setzen, wodurch die Erstellung von leichtgewichtigen Szenen für verschiedene Situationen in einer Show. Sie können nur in mimoLive erstellt und verwaltet werden. API der Zugang ist beschränkt auf die Erlangung und abrufen. (aktivierende) Schichtgruppen.

Abfrage von Ebenensätzen

/documents/(DocumentID)/layer-sets

textileRef:9996801466400ba8908856:linkStartMarker:“Unterstützte Methoden: "GET"
Verfügbar seit: mimoLive 5.0
Listet alle Ebenensätze für das angegebene Dokument auf.
Informationen zu den zurückgegebenen Objekten finden Sie im Datentyp "Layersets": {TOPIC-LINK+data-typesh1(}. section-layer-sets).

/documents/(DocumentID)/layer-sets/(LayerSetID)

Unterstützte Methoden: “GETtextileRef:9996801466400ba8908856:linkStartMarker:”
Gibt den durch "(LayerSetID)" angegebenen Layersatz zurück.
Informationen zu den zurückgegebenen Objekten finden Sie im Datentyp "Layersets": {TOPIC-LINK+data-typesh1(}. section-layer-sets).

Ebenensatz-Aktionen

/documents/(DocumentID)/layer-sets/(LayerSetID)/recall

Unterstützte Methoden: "GET" "POST"
Ruft den durch "(LayerSetID)" angegebenen Ebenensatz auf (aktiviert ihn), wodurch alle Ebenen den im Ebenensatz aufgezeichneten Live-Zustand annehmen.
Gibt die Ebene zurück, die nach dem Aufrufen eingestellt wurde, d. h. mit "aktiv == true".

Daten-Speicher

/Dokumente/(DocumentID)/Datenspeicher/(StoreID)

Unterstützte Methoden: "GET", "PUT", "DELETE"
mimoLive bietet die Möglichkeit, von Ihnen bereitgestellte Daten innerhalb der Dokumentendatei zu speichern, um z.B. einen Zustand zu einem späteren Zeitpunkt wiederherzustellen. Es steht Ihnen frei, eine "StoreID" selbst zu wählen, aber beachten Sie, dass es keine Möglichkeit gibt, alle mit einem Dokument verbundenen Datenspeicher aufzulisten (Sie können jedoch eine Art von Index Speicher, der den Überblick über Ihre anderen, dynamisch benannten Speicher behält).

Erstellen/Aktualisieren eines Datenspeichers

Um einen Datenspeicher zu erstellen oder zu aktualisieren, senden Sie eine "PUT"Anfrage an eine "StoreID" Ihrer Wahl mit den zugehörigen Daten im Body Ihrer Anfrage. Wenn die Operation erfolgreich war, antwortet mimoLive mit einem "200 OK" Status.

Inhalt eines Datenspeichers lesen

Um einen zuvor gespeicherten Datenspeicher zu lesen, fordern Sie ihn einfach über "GET". Die Daten werden genau so zurückgegeben, wie Sie sie im Feld "PUT"Anfrage, um es zu speichern. Wenn kein Datenspeicher mit dieser ID für dieses Dokument gefunden wurde, gibt mimoLive einen "404 Not Found"-Fehler zurück.

Einen bestehenden Datenspeicher löschen

Um einen Datenspeicher zu löschen, wenn Sie ihn nicht mehr benötigen, geben Sie einfach eine "DELETE"Anfrage für die "StoreID", die Sie löschen möchten. Für den Fall, dass der Datenspeicher gar nicht vorhanden war, antwortet mimoLive mit einem "404 Not Found"-Fehler.

Zoom Meetings

Diese Endpunkte steuern die integrierte Zoom-Client-Integration von mimoLive.

/zoom/join

Unterstützte Methoden: "GET" "POST"
Beitritt zu einem Zoom-Meeting. Typische Parameter (Senden als JSON-Body für POST oder ?param=value für GET):

Parameter	Wert Typ	Beschreibung
Meeting-Nummer	Zeichenfolge	Zoom Meeting-Nummer
Passcode	String, optional	Meeting Passcode
display-name	String, optional	Name, der im Meeting erscheinen soll
Stummschaltung-Audio	Bool, optional	Start stummgeschaltet
Stumm-Video	Bool, optional	Beginnen Sie mit Video aus

Gibt ein Statusobjekt zurück, das den Fortschritt oder Erfolg der Verbindung anzeigt.

/zoom/leave

Unterstützte Methoden: "GET" "POST"
Verlässt das aktuell verbundene Meeting. Gibt ein Statusobjekt zurück.

/zoom/end

Unterstützte Methoden: "GET" "POST"
Versucht, das aktuelle Zoom-Meeting zu beenden/beenden (reine Host-Aktion). Gibt einen Erfolg zurück, wenn das Meeting beendet wurde, oder einen Konflikt, wenn der Client keine Berechtigung hat.

/zoom/teilnehmer

Unterstützte Methoden: "GET" "POST"
Retourniert die aktuelle Teilnehmerliste für das beigetretene Meeting (Namen, IDs und Grundstatus).

Wert Schlüssel	Wert Typ	Beschreibung
Name	Zeichenfolge	Name des Zoom-Teilnehmers
id	Integer	Benutzer-ID des Zoom-Teilnehmers
userRole	Zeichenfolge
isHost	Bool	true, wenn der Benutzer der Gastgeber des Meetings ist
isCoHost	Bool	true, wenn der Benutzer Mitveranstalter des Meetings ist
isVideoOn	Bool	true, wenn der Benutzer Video aktiviert hat
isAudioOn	Bool	true, wenn der Benutzer Audio aktiviert hat
isTalking	Bool	true, wenn der Benutzer gerade ein Gespräch führt
isRaisingHand	Bool	true, wenn der Benutzer gerade seine Hand hebt

/zoom/meetingaction

Führt eine Aktion aus, die sich auf ein Meeting bezieht. Geben Sie Aktion und optionale Argumente per JSON-Body oder Query-String an.

Parameter	Wert Typ	Beschreibung
Befehl	Zeichenfolge	Ein Befehl aus der folgenden Liste
Benutzerkennung	String, optional	Einige Befehle erfordern eine Benutzer-ID
Bildschirmtyp	String, optional	Einige Befehle erfordern einen Bildschirmtyp

Befehl	Beschreibung
requestRecordingPermission	Senden Sie eine Anfrage für eine lokale Aufnahmegenehmigung.
stummschaltenVideo	Stummschalten des Videos eines Benutzers. (erfordert den Parameter userid)
unmuteVideo	Stummschaltung des Videos eines Benutzers aufheben. (erfordert den Parameter userid)
muteAudio	Stummschalten des Tons eines Benutzers. (erfordert den Parameter userid)
unmuteAudio	Stummschaltung des Audios eines Benutzers aufheben. (erfordert den Parameter userid)
enableUnmuteBySelf	Aktivieren Sie die Funktion, dass Benutzer die Stummschaltung aufheben können, wenn sie stummgeschaltet sind, und zwar nur für den Gastgeber/Co-Host.
disableUnmuteBySelf	Deaktivieren Sie die Funktion, dass Benutzer die Stummschaltung nicht aufheben können, wenn sie stummgeschaltet ist, die nur für den Gastgeber/Co-Host verfügbar ist.
Alle stummschalten	Alle Teilnehmer des Meetings stummschalten, nur für den Gastgeber/Co-Gastgeber verfügbar.
Alle abschalten	Schalten Sie die Stummschaltung für alle Teilnehmer des Meetings auf, die nur für den Gastgeber/Co-Gastgeber verfügbar ist.
lockMeeting	Sperren Sie das Meeting, das nur für den Gastgeber/Co-Gastgeber verfügbar ist. Nach dem Sperren können neue Teilnehmer nicht mehr teilnehmen.
unlockMeeting	Entsperren des Meetings, nur für den Gastgeber/Co-Gastgeber verfügbar.
lowerAllHands	Legen Sie die Hände aller Teilnehmer ab, die nur für den Gastgeber/Co-Gastgeber verfügbar sind.
shareFitWindowMode	Passen Sie die Anzeigegröße an das Fenster an.
pauseShare	Pause teilen.
resumeShare	Lebenslauf teilen.
joinVoip	Nehmen Sie über VoIP an einem Meeting teil.
leaveVoip	Trennen Sie die VoIP-Verbindung zum Meeting.
allowParticipantsToChat	Aktivieren Sie die Funktion, dass Benutzer untereinander chatten können.
disallowParticipantsToChat	Deaktivieren Sie die Funktion, dass Benutzer untereinander chatten können.
allowParticipantsToShare	Aktivieren Sie die Funktion, dass Benutzer ihren Bildschirm freigeben können.
disallowParticipantsToShare	Deaktivieren Sie die Funktion, dass Benutzer ihren Bildschirm freigeben können.
allowParticipantsToStartVideo	Aktivieren Sie die Funktion, dass Benutzer ihr Video starten können.
disallowParticipantsToStartVideo	Deaktivieren Sie die Funktion, dass Benutzer ihr Video starten können.
allowParticipantsToShareWhiteBoard	Aktivieren Sie die Funktion, dass Benutzer ein Whiteboard gemeinsam nutzen können.
disallowParticipantsToShareWhiteBoard	Deaktivieren Sie die Funktion, dass Benutzer ein Whiteboard gemeinsam nutzen können.
enableAutoAllowLocalRecordingRequest	Aktivieren Sie die Funktion, dass Benutzeranfragen zur Aufnahme automatisch akzeptiert werden.
disableAutoAllowLocalRecordingRequest	Deaktivieren Sie die Funktion, dass Benutzeranfragen zur Aufnahme automatisch akzeptiert werden.
allowParticipantsToRename	Aktivieren Sie die Funktion, dass Benutzer sich selbst umbenennen können.
disallowParticipantsToRename	Deaktivieren Sie die Funktion, dass Benutzer sich selbst umbenennen können.
showParticipantProfilePictures	Schalten Sie die Option zur Anzeige von Profilbildern der Teilnehmer ein.
hideParticipantProfilePictures	Schalten Sie die Option zur Anzeige von Profilbildern von Teilnehmern aus.

Beispiel Verwendung

Diese Endpunkte der mimoLive HTTP-API können auf viele Arten genutzt werden. Bitte lesen Sie den Abschnitt Beispiele für die API-Nutzung, um mehr zu erfahren.