Contenido compartido para dispositivos

Con las funciones de contenido compartido para dispositivos las personas pueden compartir contenidos en Facebook desde sus dispositivos de forma sencilla, Esto incluye Smart TV, marcos de fotos digitales o dispositivos IoT (“Internet of Things”).

Con estas funciones, el dispositivo muestra un código alfanumérico y pide a las personas que lo introduzcan en una página web desde su ordenador o smartphone. Las personas que utilicen tu aplicación o servicio pueden entonces compartir contenido en Facebook mediante un cuadro de diálogo asociado al código.

Si vas a crear una aplicación para Apple TV o dispositivos Android, debes utilizar nuestros SDK para tvOS o Android, respectivamente.

Esta guía describe lo siguiente:

Experiencia del usuario

1. Llamada a la acción

En primer lugar, piensa en qué fase de la experiencia quieres solicitar a la persona que comparta contenido en Facebook. Para garantizar la mejor experiencia posible, diseña el botón de modo que se parezca tanto como puedas al botón “Compartir” oficial de Facebook. En términos generales, el botón debe encontrarse junto al contenido que se va a compartir.

Desde la perspectiva del diseño visual, esto significa que deberías:

  1. Etiquetar el botón con “Compartir” o “Compartir en Facebook”.
  2. Utilizar el blanco y el azul oficial de la marca de Facebook (#3B5998).
  3. Si el dispositivo permite la visualización gráfica, también puedes incorporar el logotipo “f” oficial. Según las directrices de marca de Facebook, este siempre debería ser de color blanco o azul de Facebook (n.º 3B5998).

2. Visualización del código

Cuando alguien hace clic en la llamada a la acción, el dispositivo realiza una llamada a la API de Facebook que devuelve un código.

En tu interfaz, indica a las personas que deben visitar un sitio web e introducir el código usando el siguiente mensaje: “A continuación, visita facebook.com/device (http://facebook.com/device) en tu ordenador o smartphone e introduce este código”. Muestra el código completo que has recibido de la API de contenido compartido para dispositivos de Facebook. El código tiene entre 6 y 12 caracteres de longitud.

Puedes incluir un botón Close o Done para que la persona pueda finalizar el proceso de contenido compartido para dispositivos.

3. Función de compartir contenido

Este es el proceso que ve alguien cuando visita facebook.com/device en el navegador de su ordenador o smartphone. Primero aparece un campo de texto donde puede introducir el código:

Una vez que escriba el código y haga clic en Continue, se mostrará un cuadro de diálogo de contenido compartido:

De este modo, la persona sabrá que el contenido se ha compartido correctamente; además, se mostrará un mensaje de confirmación:

Implementación de las funciones de contenido compartido para dispositivos

Las funciones de contenido compartido para dispositivos de Facebook están dirigidas a dispositivos que puedan realizar llamadas HTTP a través de internet. A continuación encontrarás una lista con las llamadas a la API y las respuestas que el dispositivo puede realizar.

1. Activación del inicio de sesión para dispositivos

Carga el panel de la aplicación y sigue estos pasos: “Configuración > Opciones avanzadas > Configuración OAuth > Iniciar sesión desde dispositivos”. Cambia esta última opción a “Sí”.

2. Generación de un código

Cuando la persona haga clic en la llamada a la acción Share, el dispositivo debe realizar una acción HTTP POST en:

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

CLIENT_TOKEN se encuentra en Configuración de la aplicación -> Opciones avanzadas y debe combinarse con su identificador de la aplicación (separado con una barra vertical, |) para formar el parámetro access_token completo.

La API también admite action_type y action_properties en lugar de href en caso de que quieras compartir historias de Open Graph (del mismo modo que las acciones de Open Graph en el cuadro de diálogo de contenido compartido).

La API también admite los parámetros quote y hashtag (de la misma forma que los parámetros del cuadro de diálogo de contenido compartido).

La respuesta tiene esta forma:

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

Con esta respuesta:

  1. Se muestra la cadena A1NWZ9 en tu dispositivo.
  2. Se indica a la persona que vaya a “facebook.com/device” y especifique el código.
  3. El código caduca en 420 segundos. Transcurrido ese período, el código debe dejar de visualizarse.

3. Visualización del código

El dispositivo debe mostrar el elemento user_code e indicar a la persona que debe visitar la URI verification_uri, por ejemplo, facebook.com/device, con su ordenador o smartphone. Consulta Experiencia del usuario.

Solución de problemas

¿Puedo realizar solicitudes de flujo de dispositivo a través de HTTP?
Con identificadores, la API Graph requiere TLS/HTTPS.

¿Puedo realizar solicitudes de flujo de dispositivo con el método GET?
Todas las solicitudes de flujo de dispositivo deben ser POST.

¿Puedo saber cuándo comparte la persona contenido?
No.

¿Puedo publicar en nombre de la persona mediante programación?
No. Para hacerlo, debes pedirle al usuario que inicie sesión y te conceda permiso para publicar en su nombre. Para obtener más información, consulta Publicar con la API Graph.