Einleitung
Das Abrufen aller Aufnahmeprofile für ein Konto ist unkompliziert – es ist nur ein einfacher Aufruf der API. Was weniger einfach ist, ist, was Sie mit ihnen tun. Wenn Sie Benutzern die Profile in einer App zur Auswahl anzeigen möchten, wenn sie Videos aufnehmen, gibt es einige potenzielle Probleme, die Sie kennen und behandeln müssen:
Es gibt zwei Arten von Dynamic Delivery-Profilen, die zurückgegeben werden können:
- "statische" Profile - die gewöhnliche Art mit einem festen Satz von Wiedergaben
- "dynamische" Profile, die verwenden Kontextbewusste Codierung (CAE) um automatisch den optimalen Satz von Darstellungen zu ermitteln, der innerhalb der im Profil festgelegten Beschränkungen erstellt werden soll.
Wenn Ihre Organisation eine Präferenz für die verwendete Profilart hat oder es Fälle gibt, in denen einer dem anderen vorzuziehen ist, möchten Sie wahrscheinlich die beiden Typen gruppieren und klar unterscheiden.
Der Zweck dieses Beispiels besteht darin, Ihnen zu zeigen, wie Sie die Kontoprofile abrufen und die Ergebnisse nach den verschiedenen Typen sowie nach benutzerdefinierten Profilen filtern, die im Konto erstellt wurden.
Berechtigung abrufen
Um die Ingest Profiles API zu verwenden, benötigen Sie die richtigen Anmeldeinformationen.
Der einfachste Weg, um Anmeldeinformationen zu erhalten, ist in den meisten Fällen der Abschnitt Studio-Admin-API-Authentifizierung (erfordert Administratorberechtigungen für Ihr Konto). Sehen Verwalten von Anmeldeinformationen für die API-Authentifizierung für Details. In den meisten Fällen möchten Sie wahrscheinlich nur Berechtigungen für alle Vorgänge der Ingest Profiles API erhalten:
Wenn die benötigten Berechtigungen in Studio nicht verfügbar sind oder wenn Sie sie lieber direkt von der OAuth-API erhalten möchten, verwenden Sie Ihre Wahl aus der Erhalten Sie Client-Anmeldeinformationen unten aufgeführten Dokumente. Für welche Option Sie sich auch entscheiden, Sie müssen nach den richtigen Betriebsberechtigungen fragen. Folgendes kann mit cURL oder Postman verwendet werden, um alle Berechtigungen für die Ingest Profiles API zu erhalten:
"operations": [
"video-cloud/ingest-profiles/profile/read",
"video-cloud/ingest-profiles/profile/write",
"video-cloud/ingest-profiles/account/read",
"video-cloud/ingest-profiles/account/write"
]
Die App
Quellcode
Suchen Sie den gesamten Code, der mit diesem Beispiel verknüpft ist, in diesem GitHub-Repository.
Beispiel-App
Siehe den Stift Ingest Profiles API-Beispiel: Rufen Sie alle Profile für ein Konto von Brightcove Learning Services (@rcrooks1969) auf CodePen ab.
CodePen verwenden
Hier sind einige Tipps zur effektiven Verwendung des obigen CodePen:
- Schalten Sie die aktuelle Anzeige des Players um, indem Sie auf klicken Ergebnis Taste.
- Drücke den HTML/CSS/JS Tasten, um EINEN der Codetypen anzuzeigen.
- Klicken Auf CodePen bearbeiten in der oberen rechten Ecke, um diesen CodePen Ihrem eigenen Konto zuzuordnen.
- Suchen Sie den gesamten Code, der mit diesem Beispiel verknüpft ist, in diesem GitHub-Repository.
Proxy-Code
Um Ihre eigene Version der Beispiel-App auf dieser Seite zu erstellen, müssen Sie Ihren eigenen Proxy erstellen und hosten. (Die von Brightcove Learning Services verwendeten Proxys akzeptieren nur Anfragen von Brightcove-Domains.) Ein Beispielproxy, der dem von uns verwendeten sehr ähnlich ist, aber ohne die Prüfungen, die Anfragen von Nicht-BrightCove-Domänen blockieren, kann in diesem GitHub-Repository gefunden werden. Dort finden Sie auch grundlegende Anweisungen zur Verwendung und eine ausführlichere Anleitung zum Erstellen von Apps rund um den Proxy unter Verwenden der REST-APIs.