Teilen für Geräte

Mit dem Teilen für Geräte können Personen Inhalte einfach über Geräte auf Facebook teilen. Dazu zählen Smart-TVs, digitale Fotorahmen oder Internet-of-Things-Geräte.

Beim Teilen mit Geräten wird auf deinem Gerät ein alphanumerischer Code angezeigt, den Nutzer auf einer Webseite oder über ihren Desktop-PC oder ihr Smartphone eingeben müssen. Nutzer deiner App oder deines Dienstes können dann Inhalte über einen mit dem Code verknüpften Dialog „Teilen“ auf Facebook teilen.

Wenn du eine App für Apple TV oder Android-Geräte entwickelst, solltest du unser SDK für tvOS bzw. SDK für Android verwenden.

In diesem Leitfaden wird Folgendes beschrieben:

Nutzererfahrung

1. Call to Action

Überlege dir zuerst, wann du einen Nutzer dazu auffordern möchtest, Inhalte auf Facebook zu teilen. Um die beste Nutzererfahrung zu gewährleisten, sollte der Button dem offiziellen Facebook-Button „Teilen“ möglichst ähnlich sehen. Im Allgemeinen sollte der Button neben dem zu teilenden Inhalt zu finden sein.

Das bedeutet designtechnisch Folgendes:

  1. Beschrifte den Button mit „Teilen“ oder „Auf Facebook teilen“.
  2. Verwende Weiß und das offizielle Facebook-Blau: #3B5998.
  3. Wenn deine App eine graphische Anzeige unterstützt, kannst du auch das offizielle „f“-Logo einbinden. Gemäß der Facebook-Markenrichtlinien sollte das Logo immer entweder weiß oder Facebook-blau (#3B5998) sein.

2. Zeige den Code an

Wenn ein Nutzer auf den „Call to Action“-Button klickt, ruft dein Gerät die Facebook-API auf, die einen Code zurücksendet.

Informiere Nutzer über die UI mit der folgenden Nachricht, dass sie eine Webseite aufrufen und dort den Code eingeben müssen: „Besuche als Nächstes facebook.com/device (http://facebook.com/device) über deinen Desktop-PC oder dein Smartphone und gib diesen Code ein.“ Zeige den vollständigen Code an, den du von der Facebook-Device Share API (API zum Teilen mit Geräten) erhalten hast. Der Code ist zwischen 6 und 12 Zeichen lang.

Füge einen Close- oder Done-Button hinzu, damit Nutzer den Vorgang zum Teilen mit Geräten beenden können.

3. Teilen

Nutzer sehen diesen Vorgang, wenn sie facebook.com/device über ihren Desktop- oder Mobilgerät-Browser aufrufen. Ihnen wird zuerst ein Textfeld angezeigt, in das sie den Code eingeben können:

Wenn sie den Code eingeben und auf Continue klicken, wird der Dialog „Teilen“ angezeigt:

Damit Nutzer wissen, dass der Teilen-Vorgang erfolgreich war, erhalten sie daraufhin eine Bestätigungsnachricht:

Implementierung von Teilen für Geräte

Teilen für Geräte von Facebook ist für Geräte gedacht, die HTTP-Aufrufe über das Internet durchführen können. Dein Gerät kann folgende API-Aufrufe und -Antworten durchführen und erhalten:

1. Aktiviere die Anmeldung für Geräte

Lade dein App-Dashboard und wähle unter „Einstellungen > Erweitert >OAuth-Einstellungen > Anmeldung über Geräte“ „Ja“ aus.

2. Generiere einen Code

Wenn ein Nutzer auf den „Call to Action“-Button Share klickt, sollte dein Gerät einen HTTP-POST abschicken:

POST https://graph.facebook.com/device/share
       access_token=<APPID|CLIENT_TOKEN>
       href=<LINK_TO_SHARE>

Der CLIENT_TOKEN befindet sich in den App-Einstellungen unter „Erweitert“ und sollte mit deiner App-ID kombiniert werden (durch ein Pipe-Zeichen | getrennt), um den vollständigen access_token zu bilden.

Die API unterstützt auch action_type und action_properties anstelle von href, wenn du eine Open Graph-Meldung teilen möchtest (mit dem gleichen Verfahren wie für Open Graph-Handlungen im Dialog „Teilen“).

Die API unterstützt auch die Parameter quote und hashtag, und zwar auf die gleiche Weise wie die Parameter für den Dialog „Teilen“.

Die Antwort hat folgende Form:

{
  "user_code": "A1NWZ9",
  "verification_uri": "https://www.facebook.com/device",
  "expires_in": 420,
}

Diese Antwort bedeutet Folgendes:

  1. Zeige den String „A1NWZ9“ auf deinem Gerät an.
  2. Fordere den Nutzer auf, „facebook.com/device“ aufzurufen und den Code einzugeben.
  3. Der Code läuft nach 420 Sekunden ab. Du solltest dafür sorgen, dass die Codeanzeige nach dieser Zeitspanne geschlossen wird.

3. Zeige den Code an

Dein Gerät sollte den user_code anzeigen und den Nutzer auffordern, die verification_uri (z. B. facebook.com/device) über den PC oder das Smartphone aufzurufen. Siehe Nutzererfahrung.

Problembehebung

Kann ich Gerätevorgangsanfragen über HTTP durchführen?
Graph API mit Schlüsseln erfordert TLS/HTTPS.

Kann ich Gerätevorgangsanfragen mit der GET-Methode durchführen?
Alle Gerätevorgangsanfragen sollten POST-Anfragen sein.

Kann ich erkennen, wenn eine Person einen Teilen-Vorgang abgeschlossen hat?
Nein.

Kann ich programmatisch im Namen der Person posten?
Nein. Dazu musst du den Nutzer auffordern, sich anzumelden und dir Berechtigungen zu erteilen, Meldungen in seinem Namen zu veröffentlichen. Weitere Infos dazu findest du unter Veröffentlichen mit der Graph API.