# Player

Mit dem 3Q Player können Sie Audio- oder Video-Livestreams sowie Audio- oder Videodateien (OnDemand) wiedergegeben. 

Der Player ab Version 5 ist vollständig WCAG A-konform, einschließlich:  

1. Aria-Tags: aria-label, aria-hidden, aria-controls, aria-live 
2. Unterstützung für Bildschirmlesegeräte
3. Mindestkontrasts ≥ 4,5:1 in allen Steuerelementen mit Standard-Player-Farbe 
4. Unterstützung der Tab-Navigation

Über das Kofigurationsmenü und die Player-API lässt sich ein Player an die jeweiligen Anwendungen anpassen. Die Player werden im Kontobereich "**Player"** angelegt, bearbeitet und den Projekten zugewiesen. Im Projekt werden die zugewiesenen Player als Auswahloption im Playoutmanagement angezeigt.

<figure><img src="https://59703589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkQg21V1sTKk5IFO6nIKJ%2Fuploads%2FHi6W2SPoQzyWFA8AIOko%2Finterface_player_audio%20ondemand.png?alt=media&#x26;token=a9f37992-27b4-49c9-92db-3f0fde6ed2bc" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://59703589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkQg21V1sTKk5IFO6nIKJ%2Fuploads%2FSo6SZ65ysqVQ2G3nfchH%2Fsdn_interface_player_beispiel_podcast.png?alt=media&#x26;token=68ad2764-365a-4859-a432-d2f05123add4" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://59703589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkQg21V1sTKk5IFO6nIKJ%2Fuploads%2FqCigGtYlDGMSu331u19Y%2Finterface_player_videoplayer_ondemand.png?alt=media&#x26;token=5b1b2365-2200-433d-8933-01cdfb8eff5d" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://59703589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkQg21V1sTKk5IFO6nIKJ%2Fuploads%2FzggAK2qryuMnYCj5xXwz%2Fsdn_interface_player_beispiel_multichannel.png?alt=media&#x26;token=6fc8ca93-263a-47fb-b925-0928fd2b4da1" alt="" width="563"><figcaption></figcaption></figure>

Der 3Q Player ist in JavaScript geschrieben und arbeitet mit den Streaming-Protokollen HLS, DASH und Progressive Download. Er benutzt unterschiedliche Open Source-Bibliotheken, welche teilweise zusammen kompiliert werden, um die Hauptanwendung zu generieren (js3q.latest.js), aber auch als Plugins geladen werden (cast\_framework.js, cast\_sender.js). Plugins wie Chromecast können Sie optional in der Player-Konfiguration ausschalten.

{% hint style="info" %}
Der Kontobereich ***Player*** muss bei der Ersteinrichtung eines Kundenkontos über die Modulverwaltung dem Konto hinzugefügt werden.
{% endhint %}

## Default Player <a href="#page_einen_default_player_erstellen" id="page_einen_default_player_erstellen"></a>

Dieser Standard-Player wird beim Anlegen des Kundenkontos automatisch erstellt. Er wird von jedem Projekt im Benutzerkonto verwendet, bis Sie weitere Player erstellen und zuweisen.&#x20;

<figure><img src="https://59703589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkQg21V1sTKk5IFO6nIKJ%2Fuploads%2F6HaG5XCemlIx5c84hnOw%2Fsdn_interface_player_defaultplayer.png?alt=media&#x26;token=0446060b-41b7-474e-a35a-5ee02e760dfa" alt="" width="563"><figcaption></figcaption></figure>

Der *Default Player* kann bearbeitet, aber nicht einem einzelnen Projekt zugewiesen oder gelöscht werden. Wenn Sie diesen Player duplizieren, verhält sich das Duplikat wie ein [normaler Player](#user-content-fn-1)[^1].

## Player-Verwaltung

Sie öffnen die "Player-Verwaltung" im ***Hauptmenü*** über den Menüpunkt ***Player.***

Die Player-Verwaltung bietet eine Übersicht der angelegten Player. Hier erstellen Sie die Player für Ihre Projekte. Die Player können mit unterschiedlichen Konfigurationen einem oder mehreren Projekten sowie einzelnen Playouts zugewiesen werden.&#x20;

{% hint style="info" %}
Der Zugriff auf die Player-Verwaltung eines Benutzerkontos wird in der **Benutzerverwaltung** über die **Zugriffsrechte** organisiert.
{% endhint %}

Sie **öffnen** die Übersicht im **Hauptmenü** über den Menüpunkt **Player**.&#x20;

Die **Übersichtstabelle** zeigt die angelegten Player mit den Informationen:

<table><thead><tr><th width="232">Spaltenbezeichnung</th><th>Spaltenwert</th><th data-hidden></th></tr></thead><tbody><tr><td>Name</td><td>Die individuelle Bezeichnung für den Player.</td><td></td></tr><tr><td>Projekt</td><td>Zeigt, welchen Projekten der Player zugewiesen ist.</td><td></td></tr><tr><td>Default</td><td>Dieser Player wird automatisch in Projekten verwendet, bis einem Projekt ein weiterer Player zugewiesen wird.</td><td></td></tr><tr><td>Beschreibung</td><td>Individueller Eintrag zum Player der optional beim Anlegen erstellt wird.</td><td></td></tr><tr><td>Player-ID</td><td>Wird automatisch erstellt, kann nicht geändert werden.</td><td></td></tr></tbody></table>

<figure><img src="https://59703589-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkQg21V1sTKk5IFO6nIKJ%2Fuploads%2FK3OxoHf5nEUWZCtr6x7q%2Fsdn%20interface_player_playerverwaltung_u%CC%88bersicht.png?alt=media&#x26;token=c7fa4c5f-a57b-43f3-9071-fffe5cb6c273" alt="" width="563"><figcaption></figcaption></figure>

### **Funktionen der Player-Übersicht**:&#x20;

<table><thead><tr><th>Funktion</th><th>Schaltfläche</th><th data-hidden></th></tr></thead><tbody><tr><td>Einen Player anlegen bzw. erstellen.</td><td>Button: <em><strong>Player erstellen</strong></em></td><td></td></tr><tr><td>Einen Player bearbeiten.</td><td><strong>Name</strong> des Player oder Icon: <strong>Stift</strong> im Iconmenü</td><td></td></tr><tr><td>Die Playout-Id in die Zwischenablage kopieren.</td><td>Icon: <strong>Kopie</strong> in Spalte "Playout-ID"</td><td></td></tr><tr><td>Den Player duplizieren.</td><td>Icon: <strong>Kopie</strong> im Iconmenü</td><td></td></tr><tr><td>Den Player löschen.</td><td>Icon: <strong>Mülleimer</strong> im Iconmenü</td><td></td></tr></tbody></table>

## Hinweise zum Playoutmanagement

Bei der Verwendung der Player im Projekt bzw. im Playoutmanagement sind folgende Hinweise zu beachten:

1. Beim Erstellen eines Kundenkontos wird automatisch ein ***Default Player*****&#x20;für das Konto** erstellt. Dieser Player kann bearbeitet, aber nicht gelöscht werden.&#x20;
2. Neben dem Default Player des Kontos können Sie beliebig viele weitere Player erstellen. Jeder Player steht entweder allen Projekten zur Verfügung, oder er wird einem bestimmten Projekt zugeordnet.
3. Sie können auch einen Player als **Default für ein Projekt** setzen. Es darf pro Projekt nur jeweils ein Default geben.

Wurde einem Playout kein Player zugeordnet, [steht "Keine Auswahl (Default](#user-content-fn-2)[^2])". In diesem Fall greift folgende Logik:

1. Wenn für das Projekt ein Default Player gesetzt wurde, wird dieser Player genommen.
2. Wenn es für das Projekt keinen Default Player gibt, wird der ***Default Player*** des Kontos genommen.

[^1]: Was ist denn ein „normaler Player“? Ggf. besser: „… wie der Default Player.“

[^2]: WO genau steht das? -> Ort im Screenshot ergänzen


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sdn.docs.3q.video/interface/player.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.