Streaming
Hinweis: Der Endpunkt Start streaming kann nur verwendet werden, um das Streaming von einem Kaleo Connect-Gerät zu starten. Dieser Endpunkt kann nicht verwendet werden, um das Streaming von einem Webbrowser zu starten. Alle anderen Streaming-Endpunkte steuern sowohl Browser- als auch Kaleo Connect-Geräte.
Streaming-Status abrufen
Aktuelle Sitzung und gemeinsame Kircheneinstellungen lesen. Alle Felder sind vorhanden, auch im Leerlauf.
Pfadparameter
churchIdIhre Kirchen-ID. Kopieren Sie sie von der API-Seite (unter Integrationen) in Ihrem Dashboard.
Streaming-Status abrufen › Antworten
Erfolg
streamingtrue während einer aktiven Sitzung, einschließlich Start, Wiederverbindung und Beendigung. Bestätigt nicht, dass Audio ankommt.
sessionIdAktuelle Sitzungs-ID; null im Leerlauf.
startedAtStartzeit der aktuellen Sitzung; null im Leerlauf.
deadlineAtAutomatische Stoppzeit; null im Leerlauf oder wenn keine Frist aufgezeichnet ist.
speakerLanguageAktueller Sprecher-Sprachcode; null im Leerlauf.
targetLanguagesAktuelle Übersetzungssprachcodes; leer im Leerlauf.
voiceÜbersetzungsstimme, auch im Leerlauf.
visibletrue zeigt Untertitel an; false blendet sie aus. Gilt auch im Leerlauf.
publisherKaleo Connect-Gerät oder Browser, der Audio sendet; null im Leerlauf.
phaseSitzungsphase; Leerlauf bedeutet, dass keine Sitzung aktiv ist.
Kirchliche Standardwerte für den nächsten manuellen Start. Aktive Sitzungsüberschreibungen ändern diese Werte nicht.
Streaming starten
Starten Sie das Streaming auf einem Kaleo Connect-Gerät mit gespeicherten Einstellungen. Der optionale Body kann eine deviceId auswählen und Einstellungen für diese Sitzung überschreiben. Ohne deviceId wählt Kaleo die standardmäßige Audioquelle, die auf der Kaleo Connect-Seite (unter Integrationen) in Ihrem Dashboard konfiguriert ist, wenn mehrere audiofähige Geräte verfügbar sind, oder das einzige verfügbare Audioquellgerät, wenn nur eines vorhanden ist.
Pfadparameter
churchIdIhre Kirchen-ID. Kopieren Sie sie von der API-Seite (unter Integrationen) in Ihrem Dashboard.
Streaming starten › Anfrageinhalt optional
deviceIdOptionale Audioquellgeräte-ID von GET /devices. Überschreibt die Standard-Audioquelle der Kirche für diese Sitzung. Wenn weggelassen, wird die gespeicherte Standard-Audioquelle oder das einzige audiofähige gekoppelte Gerät verwendet; mehrere Geräte ohne Standard erfordern eine Auswahl. Das ausgewählte Gerät muss weiterhin bereit sein.
Einstellungen nur für diese Sitzung. Weggelassene Felder verwenden gespeicherte Standardwerte.
Streaming starten › Antworten
Erfolg
streamingtrue während einer aktiven Sitzung, einschließlich Start, Wiederverbindung und Beendigung. Bestätigt nicht, dass Audio ankommt.
sessionIdAktuelle Sitzungs-ID; null im Leerlauf.
startedAtStartzeit der aktuellen Sitzung; null im Leerlauf.
deadlineAtAutomatische Stoppzeit; null im Leerlauf oder wenn keine Frist aufgezeichnet ist.
speakerLanguageAktueller Sprecher-Sprachcode; null im Leerlauf.
targetLanguagesAktuelle Übersetzungssprachcodes; leer im Leerlauf.
voiceÜbersetzungsstimme, auch im Leerlauf.
visibletrue zeigt Untertitel an; false blendet sie aus. Gilt auch im Leerlauf.
publisherKaleo Connect-Gerät oder Browser, der Audio sendet; null im Leerlauf.
phaseSitzungsphase; Leerlauf bedeutet, dass keine Sitzung aktiv ist.
Kirchliche Standardwerte für den nächsten manuellen Start. Aktive Sitzungsüberschreibungen ändern diese Werte nicht.
Streaming stoppen
Stoppen Sie die aktuelle Streaming-Sitzung. Kein Request-Body erforderlich.
Pfadparameter
churchIdIhre Kirchen-ID. Kopieren Sie sie von der API-Seite (unter Integrationen) in Ihrem Dashboard.
Streaming stoppen › Antworten
Erfolg
streamingtrue während einer aktiven Sitzung, einschließlich Start, Wiederverbindung und Beendigung. Bestätigt nicht, dass Audio ankommt.
sessionIdAktuelle Sitzungs-ID; null im Leerlauf.
startedAtStartzeit der aktuellen Sitzung; null im Leerlauf.
deadlineAtAutomatische Stoppzeit; null im Leerlauf oder wenn keine Frist aufgezeichnet ist.
speakerLanguageAktueller Sprecher-Sprachcode; null im Leerlauf.
targetLanguagesAktuelle Übersetzungssprachcodes; leer im Leerlauf.
voiceÜbersetzungsstimme, auch im Leerlauf.
visibletrue zeigt Untertitel an; false blendet sie aus. Gilt auch im Leerlauf.
publisherKaleo Connect-Gerät oder Browser, der Audio sendet; null im Leerlauf.
phaseSitzungsphase; Leerlauf bedeutet, dass keine Sitzung aktiv ist.
Kirchliche Standardwerte für den nächsten manuellen Start. Aktive Sitzungsüberschreibungen ändern diese Werte nicht.
Übersetzungsstimme ändern
Ändern Sie die Übersetzungsstimme im Leerlauf oder während des Streamings.
Pfadparameter
churchIdIhre Kirchen-ID. Kopieren Sie sie von der API-Seite (unter Integrationen) in Ihrem Dashboard.
Übersetzungsstimme ändern › Anfrageinhalt
voiceÜbersetzungsstimme. Kann im Leerlauf oder während des Streamings geändert werden.
Übersetzungsstimme ändern › Antworten
Erfolg
streamingtrue während einer aktiven Sitzung, einschließlich Start, Wiederverbindung und Beendigung. Bestätigt nicht, dass Audio ankommt.
sessionIdAktuelle Sitzungs-ID; null im Leerlauf.
startedAtStartzeit der aktuellen Sitzung; null im Leerlauf.
deadlineAtAutomatische Stoppzeit; null im Leerlauf oder wenn keine Frist aufgezeichnet ist.
speakerLanguageAktueller Sprecher-Sprachcode; null im Leerlauf.
targetLanguagesAktuelle Übersetzungssprachcodes; leer im Leerlauf.
voiceÜbersetzungsstimme, auch im Leerlauf.
visibletrue zeigt Untertitel an; false blendet sie aus. Gilt auch im Leerlauf.
publisherKaleo Connect-Gerät oder Browser, der Audio sendet; null im Leerlauf.
phaseSitzungsphase; Leerlauf bedeutet, dass keine Sitzung aktiv ist.
Kirchliche Standardwerte für den nächsten manuellen Start. Aktive Sitzungsüberschreibungen ändern diese Werte nicht.
Sichtbarkeit ändern
Untertitel im Leerlauf oder während des Streamings ein- oder ausblenden. Das Ausblenden der Untertitel stoppt die Sitzung nicht.
Pfadparameter
churchIdIhre Kirchen-ID. Kopieren Sie sie von der API-Seite (unter Integrationen) in Ihrem Dashboard.
Sichtbarkeit ändern › Anfrageinhalt
visibletrue zeigt Untertitel an; false blendet sie aus, während das Streaming fortgesetzt wird.
Sichtbarkeit ändern › Antworten
Erfolg
streamingtrue während einer aktiven Sitzung, einschließlich Start, Wiederverbindung und Beendigung. Bestätigt nicht, dass Audio ankommt.
sessionIdAktuelle Sitzungs-ID; null im Leerlauf.
startedAtStartzeit der aktuellen Sitzung; null im Leerlauf.
deadlineAtAutomatische Stoppzeit; null im Leerlauf oder wenn keine Frist aufgezeichnet ist.
speakerLanguageAktueller Sprecher-Sprachcode; null im Leerlauf.
targetLanguagesAktuelle Übersetzungssprachcodes; leer im Leerlauf.
voiceÜbersetzungsstimme, auch im Leerlauf.
visibletrue zeigt Untertitel an; false blendet sie aus. Gilt auch im Leerlauf.
publisherKaleo Connect-Gerät oder Browser, der Audio sendet; null im Leerlauf.
phaseSitzungsphase; Leerlauf bedeutet, dass keine Sitzung aktiv ist.
Kirchliche Standardwerte für den nächsten manuellen Start. Aktive Sitzungsüberschreibungen ändern diese Werte nicht.
Untertitel löschen
Löschen Sie den aktuellen Untertitel-Feed. Kein Request-Body erforderlich.
Pfadparameter
churchIdIhre Kirchen-ID. Kopieren Sie sie von der API-Seite (unter Integrationen) in Ihrem Dashboard.
Untertitel löschen › Antworten
Erfolg
streamingtrue während einer aktiven Sitzung, einschließlich Start, Wiederverbindung und Beendigung. Bestätigt nicht, dass Audio ankommt.
sessionIdAktuelle Sitzungs-ID; null im Leerlauf.
startedAtStartzeit der aktuellen Sitzung; null im Leerlauf.
deadlineAtAutomatische Stoppzeit; null im Leerlauf oder wenn keine Frist aufgezeichnet ist.
speakerLanguageAktueller Sprecher-Sprachcode; null im Leerlauf.
targetLanguagesAktuelle Übersetzungssprachcodes; leer im Leerlauf.
voiceÜbersetzungsstimme, auch im Leerlauf.
visibletrue zeigt Untertitel an; false blendet sie aus. Gilt auch im Leerlauf.
publisherKaleo Connect-Gerät oder Browser, der Audio sendet; null im Leerlauf.
phaseSitzungsphase; Leerlauf bedeutet, dass keine Sitzung aktiv ist.
Kirchliche Standardwerte für den nächsten manuellen Start. Aktive Sitzungsüberschreibungen ändern diese Werte nicht.
Auto-Stopp-Zeit ändern
Setzen Sie die Auto-Stopp-Zeit für eine aktive Sitzung. Gibt den aktualisierten Streaming-Status zurück.
Pfadparameter
churchIdIhre Kirchen-ID. Kopieren Sie sie von der API-Seite (unter Integrationen) in Ihrem Dashboard.
Auto-Stopp-Zeit ändern › Anfrageinhalt
deadlineAtZukünftige Auto-Stopp-Zeit mit Z oder Zeitzonenoffset. Spätestens sechs Stunden nach startedAt.
Auto-Stopp-Zeit ändern › Antworten
Erfolg
streamingtrue während einer aktiven Sitzung, einschließlich Start, Wiederverbindung und Beendigung. Bestätigt nicht, dass Audio ankommt.
sessionIdAktuelle Sitzungs-ID; null im Leerlauf.
startedAtStartzeit der aktuellen Sitzung; null im Leerlauf.
deadlineAtAutomatische Stoppzeit; null im Leerlauf oder wenn keine Frist aufgezeichnet ist.
speakerLanguageAktueller Sprecher-Sprachcode; null im Leerlauf.
targetLanguagesAktuelle Übersetzungssprachcodes; leer im Leerlauf.
voiceÜbersetzungsstimme, auch im Leerlauf.
visibletrue zeigt Untertitel an; false blendet sie aus. Gilt auch im Leerlauf.
publisherKaleo Connect-Gerät oder Browser, der Audio sendet; null im Leerlauf.
phaseSitzungsphase; Leerlauf bedeutet, dass keine Sitzung aktiv ist.
Kirchliche Standardwerte für den nächsten manuellen Start. Aktive Sitzungsüberschreibungen ändern diese Werte nicht.
Auto-Stopp-Zeit anpassen
Auto-Stopp-Zeit hinzufügen oder subtrahieren. Im Leerlauf die Dauer für den nächsten manuellen Start ändern. Während des Streamings die aktuelle Frist ändern. Jede Anfrage wendet eine separate Anpassung an.
Pfadparameter
churchIdIhre Kirchen-ID. Kopieren Sie sie von der API-Seite (unter Integrationen) in Ihrem Dashboard.
Auto-Stopp-Zeit anpassen › Anfrageinhalt
deltaSecondsSekunden, die zur Leerlaufdauer oder aktuellen Frist hinzugefügt werden; negative Werte subtrahieren. Kann nicht 0 sein. Leerlaufdauer: 60–21600 Sekunden. Live-Frist: zukünftig, innerhalb von sechs Stunden nach startedAt.
Auto-Stopp-Zeit anpassen › Antworten
Erfolg
streamingtrue während einer aktiven Sitzung, einschließlich Start, Wiederverbindung und Beendigung. Bestätigt nicht, dass Audio ankommt.
sessionIdAktuelle Sitzungs-ID; null im Leerlauf.
startedAtStartzeit der aktuellen Sitzung; null im Leerlauf.
deadlineAtAutomatische Stoppzeit; null im Leerlauf oder wenn keine Frist aufgezeichnet ist.
speakerLanguageAktueller Sprecher-Sprachcode; null im Leerlauf.
targetLanguagesAktuelle Übersetzungssprachcodes; leer im Leerlauf.
voiceÜbersetzungsstimme, auch im Leerlauf.
visibletrue zeigt Untertitel an; false blendet sie aus. Gilt auch im Leerlauf.
publisherKaleo Connect-Gerät oder Browser, der Audio sendet; null im Leerlauf.
phaseSitzungsphase; Leerlauf bedeutet, dass keine Sitzung aktiv ist.
Kirchliche Standardwerte für den nächsten manuellen Start. Aktive Sitzungsüberschreibungen ändern diese Werte nicht.

