Uso compartido en dispositivos

Con la función de compartir en dispositivos, las personas pueden compartir fácilmente contenido de sus dispositivos en Facebook. Esto incluye Smart TV, marcos de fotos digitales o dispositivos de Internet de las cosas.

Con la función de compartir, el dispositivo muestra un código alfanumérico y pide a las personas que lo introduzcan en una página web desde su computadora o smartphone. De ese modo, los usuarios de tu aplicación o servicio podrán compartir contenido en Facebook mediante un cuadro de diálogo de contenido compartido asociado con el código.

Si desarrollas una aplicación para Apple TV o dispositivos Android, debes usar el SDK para tvOS o el SDK para Android, respectivamente.

En esta guía se 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 las personas que compartan contenido en Facebook. Para garantizar la mejor experiencia posible, diseña un botón lo más parecido posible al botón oficial "Compartir" de Facebook. En general, el botón debe estar junto al contenido para compartir.

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

  1. Colocar la etiqueta "Compartir" o "Compartir en Facebook" en el botón.
  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 normas de marca de Facebook, el logotipo siempre deber ser de color blanco o azul de Facebook (n.º 3B5998).

2. Presentar el 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 necesitan visitar un sitio web e ingresar el código usando el siguiente mensaje: "A continuación, visita facebook.com/device (http://facebook.com/device) en tu computadora o smartphone e ingresa este código". Muestra el código completo que recibiste de la API para compartir para dispositivos de Facebook. El código tiene entre 6 y 12 caracteres de longitud.

Incluye un botón Close o Done para que las personas puedan terminar el proceso de compartir para dispositivos.

3. Uso compartido

Este es el proceso que las personas ven cuando visitan facebook.com/device con el navegador de su computadora o smartphone. Primero aparece un campo de texto donde pueden ingresar el código:

Después de que ingresan el código y hacen clic en Continue ven el cuadro de diálogo de contenido compartido:

De este modo, las personas saben que el contenido se compartió correctamente y ven un mensaje de confirmación:

Implementar la función de compartir para dispositivos

La función de compartir para dispositivos de Facebook está diseñada para dispositivos que pueden 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. Activar el inicio de sesión para dispositivos

Carga el panel de aplicaciones y sigue estos pasos: "Configuración > Avanzada > Configuración de OAuth > Iniciar sesión desde dispositivos"; cambia esta última opción a "Sí".

2. Generar un código

Cuando la persona hace 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 > Avanzada" y se debe combinar con el identificador de la aplicación (separado por una barra vertical, |) para formar el access_token completo.

Si quieres compartir una historia de Open Graph (de la misma manera que las acciones de Open Graph en el cuadro de diálogo de contenido compartido), la API también admite action_type y action_properties en lugar de href.

La API también es compatible con los parámetros quote y hashtag (de la misma manera que los parámetros del cuadro de diálogo).

La respuesta tiene esta forma:

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

Esta respuesta significa:

  1. Muestra la cadena A1NWZ9 en tu dispositivo.
  2. Indica a la persona que vaya a "facebook.com/device" e ingrese el código.
  3. El código caduca en 420 segundos. Transcurrido ese tiempo, debes cerrar la visualización del código.

3. Presentar el código

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

Solución de problemas

¿Puedo hacer solicitudes de flujo de dispositivo a través de HTTP?
La API Graph con tokens requiere TLS/HTTPS.

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

¿Puedo saber cuándo una persona completó un proceso de compartir?
No.

¿Puedo publicar en nombre de la persona de manera programática?
No. Para hacerlo, debes pedir al usuario que inicie sesión y te conceda los permisos para publicar en su nombre. Consulta Publicar con la API Graph para obtener más información.