# Player erstellen/bearbeiten

Öffnen Sie über das ***Hauptmenü*** den Bereich ***Player.*** In der Player-Übersicht nutzen Sie:

* den Button: ***Player erstellen*** - um einen neuen **Player anzulegen**
* das ***Stift Icon -*** um einen angelegten **Player zu bearbeiten**

Beide Optionen öffnen den Konfigurationsbereich des Players.

{% hint style="info" %}
Player, die bereits verwendet werden, übernehmen die hier geänderten Einstellungen automatisch. Ein erneutes Einbetten des Playercodes in eine Webseite nach Einstellungsänderungen ist nicht nötig.
{% endhint %}

<figure><img src="/files/vzCDEnzH7PTI47Tx0KSI" alt=""><figcaption></figcaption></figure>

## Player-Konfiguration

Die Ansicht gliedert sich in drei Bereiche:

1. **Grundeinstellungen**  - für Projektzuweisungen und Metadaten zur Playerverwaltung
2. **Playereigenschaften** - zur Anpassung des Players an den Verwendungszweck
3. **Vorschauplayer**         - zur direkten Überprüfung von Einstellungen

<figure><img src="/files/z1nIFS0jhxAFF8ZAcedq" alt="" width="563"><figcaption></figcaption></figure>

## 1. Grundeinstellungen <a href="#page_design" id="page_design"></a>

### **Projekt** <a href="#page_das_projekt_auswahlen" id="page_das_projekt_auswahlen"></a>

Im Dropdown-Menü ***Projekt*** werden alle verfügbaren Projekte des Benutzerkontos angezeigt. Per Klick legen Sie fest, für welches Projekt die Playerkonfiguration verwendet werden soll.&#x20;

{% hint style="info" %}
Wird kein Projekt gewählt, verwenden **alle Projekte** des Benutzerkontos, denen kein Player zugewiesen ist, diesen Player.

Wenn das Häkchen für **Default** gesetzt wird, verliert der bisherige Defaultplayer diesen Status. Ein Defaultplayer kann nicht mehr einem einzelnen Projekt zugewiesen werden.
{% endhint %}

<figure><img src="/files/E4kpDQBg22ajEzpZJIkL" alt="" width="563"><figcaption></figcaption></figure>

Nach der Auswahl wird die Zuweisung in der Player-Übersicht unter *Projekte* wie folgt angezeigt:

* mit dem Namen des zugewiesenen Projekts
* oder für "<mark style="background-color:blue;">Alle Projekte</mark>", blau hinterlegt
* oder für den Defaultplayer "<mark style="background-color:green;">Alle Projekte</mark>", grün hinterlegt&#x20;

### Name und Beschreibung

Hinterlegen Sie für den Player einen Namen und optional eine Beschreibung. Der Name wird in der Player-Übersicht und auf Projektebene im Playoutmanagement verwendet. Die Beschreibung wird in der Player-Übersicht angezeigt.&#x20;

[Zum Abschluss **speichern** Sie die Einstellungen](#user-content-fn-1)[^1].

## 2. Eigenschaften bearbeiten

Hier nehmen Sie **allgemeine Einstellungen** zum Erscheinungsbild und dem Playerverhalten vor und wählen Sicherheitsoptionen für den Player. In den **speziellen Einstellungen** legen Sie fest, für welchen Medientyp der Player verwendet wird und welche zusätzlichen Darstellungsoptionen verwendet werden sollen. Über das **Reitermenü** wechseln Sie in den gewünschten Einstellungsbereich.

<figure><img src="/files/cxrpBpwMuXuz05Y1Grzt" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Beachten Sie, dass Einstellungsoptionen, die sich auf Module beziehen, erst wirksam werden, wenn das Modul gebucht wurde.
{% endhint %}

### Allgemeine Einstellungen <a href="#page_design" id="page_design"></a>

### 1. Skin <a href="#page_design" id="page_design"></a>

<figure><img src="/files/FjbK7rLGPwmjUMS9aSoh" alt="" width="563"><figcaption></figcaption></figure>

#### **Leadfarbe**

Bestimmt die Farbe des Progressionsbalken, der Anzeige von Textelementen aus den Metadaten und der Markierungen im Player. Sie können den gewünschten Farbton über das Farbmenü einstellen oder den Farb-Code direkt eingeben.

<figure><img src="/files/kIvdZV3lvXAuTdYwS9ud" alt="" width="368"><figcaption></figcaption></figure>

Die Auswahl des Farbtons muss im Dropdownmenü und über den Speicher-Button der Seite gespeichert werden.

{% hint style="warning" %}
Diese Einstellungsänderung wird **nicht** im Vorschauplayer des Konfigurationsbereiches angezeigt.
{% endhint %}

#### Steuerungsleiste

Bestimmt das Ausblenden der Steuerungsleiste im Videoplayer.

**Option 1**: Wenn keine der Checkboxen aktiviert ist, wird die Steuerungsleiste immer angezeigt.

**Option 2**: Wenn Checkbox **"Steuerleiste automatisch schließen"** aktiviert ist und eine "**Zeit bis zum Ausblenden der Steuerleiste"** gewählt ist, wird die Steuerungsleiste immer wieder nach dem Zeitraum ausgeblendet.&#x20;

**Option 3**: Wenn die Checkbox "**Steuerleiste im Fullscreen automatisch ausblenden"** aktiviert ist, wird die Steuerungsleiste mit einer Verzögerung von 3 Sekunden ausgeblendet.

#### Player Theme Assets (ZIP)

Hier können Sie die ZIP-Archivdatei für ein individuelles Player-Design hoch laden. Eine ausführliche Beschreibung dazu finden Sie hier:

{% embed url="<https://docs.3q.video/en/Player_API/Custom_Theme_Assets.html>" %}

{% hint style="info" %}
Diese Option erscheint erst zur Nachbearbeitung, wenn der Player bereits angelegt wurde.&#x20;
{% endhint %}

#### Player Labels (JSON) <a href="#page_ausspieloptionen" id="page_ausspieloptionen"></a>

Die Textanzeigen zu den Playerelementen sind bereits in den gebräuchlichsten Sprachversionen wählbar. Bei Bedarf können Sie hier eine Datei mit einer zusätzlichen Sprachversion hochladen. Die Liste der zu übersetzenden Begriffe finden Sie hier:

{% embed url="<https://docs.3q.video/en/Player_API/Labels.html>" %}

{% hint style="info" %}
Alle Änderungen werden erst mit dem Speichern übernommen.
{% endhint %}

### 2. Optionen <a href="#page_ausspieloptionen" id="page_ausspieloptionen"></a>

<figure><img src="/files/3oB9FzOXEis5t1bieFUr" alt="" width="563"><figcaption></figcaption></figure>

#### Playerverhalten, wenn Checkboxen per Häkchen aktiviert sind:

* **Autoplay**: Die Ausspielung startet (sofern vom Browser zugelassen) mit der Initialisierung des Players automatisch.
* **Loop**: Der Inhalt wird in einer Dauerschleife abgespielt.
* **Titel anzeigen**: Anzeige der Eingabe in Metadaten "Anzeige Player Titel 1 und 2"
* **Erlaube stummes Starten** (Autoplay Policy): Inhalte können (sofern vom Browser zugelassen) auf mobilen Geräten ohne Ton abgespielt werden.
* **Scroll to Play**: Der Inhalt wird abgespielt, wenn der Player den sichtbaren Webseitenbereich erreicht.
* **Stumm**: Der Inhalt wird (sofern vom Browser zugelassen) ohne Ton abgespielt.
* **Sticky Player**: Das Video wird beim Abwärts-Scrollen automatisch in einer verkleinerten Größe am oberen Bildschirmrand fix positioniert.
* **SEO Optimierung** - Gibt die hinterlegten Metadaten für Suchmaschinen-Crawler frei.
* **Video Analytics Tracking** - Das Tracking für die Auswertungen im Analytics Modul ist aktiv.
* **Tracking Cookie verwenden** - Bei Deaktivierung dieser Option wird das Tracking ohne Verwendung eines Cookies durchgeführt.
* **Chromecast aktivieren:** Die Chromecast-Funktionalität steht zur Verfügung. **Wichtig:** Diese Funktion setzt Google Cookies.

#### Playerverhalten, wenn folgende Auswahloptionen genutzt werden:

* **Sprache für Playerelemente** - Es wird die Sprache aus den Browsereinstellungen des Nutzers (Default des Browsers) oder die im Menü gewählte Sprache für die Bezeichnungen im Player verwendet.
* **Untertitel** - Zum Start wird die Sprache aus den Browsereinstellungen des Nutzers (Default des Browsers) oder die im Menü gewählte Sprache für die Anzeige der Untertitel im Player verwendet. Der Nutzer kann später eine alternative Untertitelversion wählen.
* **Tonspur** - Zum Start wird die Sprache aus den Browsereinstellungen des Nutzers (Default des Browsers) oder eine aus der Liste gewählte Sprache verwendet. Der Nutzer kann später eine alternative Tonspur wählen.
* **Initiale Qualitätsstufe**: Legt die Auflösung fest, mit der der Player unabhängig vom Endgerät startet. Nachdem der Player die Bandbreite der Internetverbindung festgestellt hat, wechselt er automatisch in die optimale Qualitätsstufe.
* **Sharing Icons** - Die gewählten Social Media Icons werden eingeblendet

{% hint style="info" %}
Alle Änderungen werden erst mit dem Speichern übernommen.
{% endhint %}

### 3. Sicherheit <a href="#page_module_verwenden" id="page_module_verwenden"></a>

<figure><img src="/files/wpZNcOLvwIAVEXxd6QGf" alt="" width="563"><figcaption></figcaption></figure>

#### Playerverhalten, wenn Checkboxen per Häkchen aktiviert sind:

* **Schutz des Players mit Token** - Die Token-basierte Validierung von Nutzerzugriffen wird ausgeführt. Siehe Anleitung: <https://docs.3q.video/en/Player_API/Basic_usage.html>
* **Domainschutz (Embedding)** - Der Player lässt sich nur innerhalb der/den hinterlegten Domain(s) nutzen/einbetten. Es können mehrere Domains angelegt werden.
* **Passwortschutz** - Der Player lässt sich nur mit Eingabe des hinterlegten Passwortes nutzen.
* **DRM verwenden** - Die Inhalte werden mit DRM-Lizenzen ausgeliefert.
* **Vorschau -** Wenn ein Nutzer nicht berechtigt ist, das Video anzusehen, wird eine Vorschau mit definierter Dauer (10 bis 120 Sekunden einstellbar) angezeigt.
* **Geo/IP-Blocking** - Das gewählte Blocking-Template wird ausgeführt. Es werden mit Klick in den Auswahlbereich alle Blockingtemplates angezeigt, die im Modul **IP/GeoBlocking** angelegt wurden.

{% hint style="info" %}
Alle Einstellungen werden erst mit dem Speichern ausgeführt.
{% endhint %}

### Spezielle Einstellungen <a href="#page_module_verwenden" id="page_module_verwenden"></a>

{% hint style="info" %}
Zur Verwendung der Einstellungsoptionen Playlists, Podcast und Werbung müssen die eintsprechenden Module aktiv sein.
{% endhint %}

### 1. Playlists <a href="#page_module_verwenden" id="page_module_verwenden"></a>

Die Einstellungen werden nur bei der Wiedergabe von Playlisten verwendet. Eine Beschreibung der Einstellungen finden Sie im Kapitel [Playlist-Player](/interface/player/playlist-player.md).

### 2. Podcasts <a href="#page_monetarisierung_tracking" id="page_monetarisierung_tracking"></a>

Die Einstellungen werden nur bei der Wiedergabe von Podcasts verwendet.

<figure><img src="/files/OM95ZKmaD3fsVQKN0T4j" alt="" width="563"><figcaption></figcaption></figure>

#### Playerverhalten, wenn Checkboxen per Häkchen aktiviert sind:

* Podcast Episodenliste im Player deaktivieren - Liste mit Episoden wird nicht angezeigt
* Podcast Episodenliste bei Initialisierung des Players öffnen - Liste mit Episoden wird automatisch geöffnet/angezeigt
* Podcast-Items in der Player-Konfiguration für Dateien ausgeben - es wird immer nur die erste (aktuellste) Episode des Podcasts angezeigt und abgespielt

#### Playerverhalten, wenn folgende Auswahloptionen genutzt werden:

* **Maximale Items im Podcast (Sichtbar)** - bestimmt die Länge der Liste mit angezeigten Episoden
* **Maximale Items im Podcast** - begrenzt die Anzahl der hinzufügbaren Dateien&#x20;

{% hint style="info" %}
Die Einstellungen werden erst nach dem Speichern wirksam.
{% endhint %}

### 3. OnDemand <a href="#page_monetarisierung_tracking" id="page_monetarisierung_tracking"></a>

Die Player-Option "Abspielgeschwindigkeit einstellbar" wird nur für die Wiedergabe von Audio- oder Videodateien verwendet.

<figure><img src="/files/H1KloMToPrFFuqSlPh2f" alt="" width="563"><figcaption></figcaption></figure>

In den "Player-Einstellungen" kann der Nutzer dann die Abspielgeschwindigkeit ändern.

<figure><img src="/files/zSUDpQPLlHA2HoTibiTz" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
Die Einstellung wird erst nach dem Speichern im Player verfügbar.
{% endhint %}

### 4. Live Streaming <a href="#page_monetarisierung_tracking" id="page_monetarisierung_tracking"></a>

Die Einstellungen werden nur bei der Wiedergabe von Video-Livestreams verwendet.

<figure><img src="/files/cXv8wMuxU6oy7a2gHHBb" alt="" width="563"><figcaption></figcaption></figure>

#### Playerverhalten, wenn Checkboxen per Häkchen aktiviert sind:

* **Timeshift im Player deaktivieren** - Die Funktion "Timeshift" steht den Nutzern im Player nicht zur Verfügung, aber im Projekt kann "Timshift to VoD" genutzt werden, wenn unter **Eingangssignal** eine "**Verfügbare Timeshift Zeit**" hinterlegt ist.&#x20;
* **Kommentare aktivieren** - Das Kommentarfenster wird im Player angezeigt.
* **Benutzername des Kommentars ist schreibgeschützt** - Der Nutzer kann den Benutzernamen nicht mehr bearbeiten, wenn dieser via SSO-Login automatisch ins Kommentarfeld übertragen wurde **oder** nachdem der erste Kommentar verfasst wurde.

{% hint style="info" %}
Die Einstellungen werde erst nach dem Speichern ausgeführt.
{% endhint %}

### 5. Werbung <a href="#page_monetarisierung_tracking" id="page_monetarisierung_tracking"></a>

<figure><img src="/files/LBcdec2jqbGXjgzfEGJ8" alt="" width="563"><figcaption></figcaption></figure>

* **Werbung aktivieren** - Die Ads werden, wie im Modul "Video Advertising" eingestellt, ausgeliefert.
* **Ausschließlich folgendes AdTag verwenden** - Das ausgewählte AdTag wird ausgeführt. Alternativ kann die Einstellung "Unverändert" gewählt werden. Dann werden alle aktiven AdTags, wie im Modul eingestellt, genutzt.

{% hint style="info" %}
Die Einstellungen werde erst nach dem Speichern ausgeführt.
{% endhint %}

### 6. Audio <a href="#page_monetarisierung_tracking" id="page_monetarisierung_tracking"></a>

Die Einstellungen werden für die Wiedergabe von Audio-Inhalten im Audioplayer verwendet.

<figure><img src="/files/IHlAbc41YlSWc7Rl4e31" alt=""><figcaption></figcaption></figure>

* [Immer als Audio Player verwenden -](#user-content-fn-2)[^2] die Dateien werden automatisch mit dem Audio-Player ausgeliefert
* Thumbnail anzeigen im Audioplayer - im Player wird das Vorschaubild angezeigt
* Beschreibung anzeigen im Audioplayer - im Player wird der Texteintrag "Beschreibung" aus den Metadaten angezeigt

{% hint style="info" %}
Die Einstellungen werde erst nach dem Speichern ausgeführt.
{% endhint %}

### 7. Intro/Outro

Sie können zu einer Videodatei ein Intro- und ein Outro-Video hinzufügen.

Dazu hinterlegen sie in dem jeweiligen Eingabefeld die Playout Id der Datei die verwendet werden soll. Diese Datei muss dazu mit dem Status "Veröffentlicht" in einem On-Demand-Projekt vorliegen.

<figure><img src="/files/IH6XZU8Ogu52x5M6Jmr5" alt=""><figcaption></figcaption></figure>

Zusätzlich können Sie für beide Positionen wählen:

* "Kann übersprungen werden"
* "Steuerleiste ausblenden während das Intro abspielt"

Die Einstellungen werde erst nach dem Speichern ausgeführt.

[^1]: Button „Speichern“ fehlt. Wenn die Änderungen automatisch übernommen werden: Satz raus

[^2]: kein Text vorhanden


---

# 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/player-erstellen-bearbeiten.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.
