Contenido compartido para dispositivos
Este extremo se retiró el 2 de noviembre de 2020.
Con la función Contenido compartido para dispositivos, se puede compartir contenido de los dispositivos en Facebook con facilidad. Se incluyen televisores inteligentes, marcos de fotos digitales o dispositivos con tecnología de internet de las cosas.
Con esta función, el dispositivo muestra un código alfanumérico e indica al usuario que lo introduzca en una página web en el ordenador o el smartphone. Tras esto, los usuarios de tu aplicación o servicio pueden compartir contenido en Facebook con un cuadro de diálogo de contenido compartido asociado al código.
Si estás creando una aplicación para dispositivos Android o Apple TV, deberías utilizar el SDK para Android o el SDK para tvOS, respectivamente.
En esta guía se describe lo siguiente:
Experiencia del usuario
1. Llamada a la acción
En primer lugar, considera en qué lugar de la experiencia quieres preguntar a los usuarios si quieren compartir contenido en Facebook. Para garantizar la mejor experiencia, diseña el botón de forma que sea lo más parecido posible al botón “Compartir” oficial de Facebook. En general, el botón debería estar al lado del contenido que se va a compartir.
Desde una perspectiva de diseño visual, esto significa que deberías hacer lo siguiente:
- Etiquetar el botón con “Compartir” o “Compartir en Facebook”.
- Usar el color blanco y el azul oficial de la marca de Facebook (#3B5998).
- Si el dispositivo admite una visualización gráfica, también puedes incorporar el logotipo oficial “f”. Según las normas de marca de Facebook, el logotipo siempre debe ser blanco o del color azul de Facebook (#3B5998).
2. Mostrar el código
Al hacer clic en la llamada a la acción, el dispositivo realiza una llamada a la API de Facebook y esta devuelve un código.
En la interfaz, indica a los usuarios que tienen que acceder a un sitio web e introducir el código con el mensaje siguiente: “A continuación, accede a facebook.com/device (http://facebook.com/device) en el ordenador o el 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.
Incluye un botón Close o Done para que los usuarios puedan finalizar el proceso de contenido compartido para dispositivos.
3. Compartir contenido
Este es el proceso que ven los usuarios al acceder a facebook.com/device en un navegador del móvil o del ordenador. En primer lugar, ven un campo de texto en el que pueden introducir el código:
Después de introducir el código y hacer clic en Continue, verán un cuadro de diálogo de contenido compartido:
De esta forma, los usuarios saben que el proceso de contenido compartido se ha realizado correctamente y ven un mensaje de confirmación:
Implementar la función Contenido compartido para dispositivos
La función de Facebook Contenido compartido para dispositivos está destinada a dispositivos que pueden realizar llamadas HTTP a través de internet. A continuación se muestran las llamadas a la API que puede hacer el dispositivo, así como las respuestas.
1. Activar el inicio de sesión para dispositivos
Carga el panel de tu aplicación y cambia “Configuración” > “Opciones avanzadas” > “Configuración de OAuth” > “Inicio de sesión desde dispositivos” a “Sí”.
2. Generar un código
Al hacer clic en la llamada a la acción Share, el dispositivo debería realizar una solicitud POST HTTP a:
POST https://graph.facebook.com/device/share
access_token=<APPID|CLIENT_TOKEN>
href=<LINK_TO_SHARE>El valor de CLIENT_TOKEN se encuentra en “Configuración de la aplicación” > “Opciones avanzadas” y se debería combinar con el identificador de la aplicación (separados por una barra vertical, |) para formar el valor completo de access_token.
La API también admite action_type y action_properties en lugar de href si quieres compartir una historia de Open Graph (de la misma forma 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 el siguiente formato:
{
"user_code": "A1NWZ9",
"verification_uri": "https://www.facebook.com/device",
"expires_in": 420,
}Esta respuesta significa lo siguiente:
- Se muestra la cadena “A1NWZ9” en el dispositivo.
- Se indica al usuario que acceda a “facebook.com/device” e introduzca este código.
- El código caduca en 420 segundos. Una vez transcurrido ese tiempo, deberías cerrar la visualización del código.
3. Mostrar el código
El dispositivo debería mostrar el valor de user_code e indicar a los usuarios que visiten el URI del parámetro verification_uri, como facebook.com/device, en el ordenador o el smartphone. Consulta Experiencia del usuario.
Solución de problemas
¿Puedo realizar solicitudes del proceso del dispositivo a través de HTTP?
La API Graph con identificadores requiere TLS/HTTPS.
¿Puedo realizar solicitudes del proceso del dispositivo con el método GET?
Todas las solicitudes del proceso del dispositivo deberían ser solicitudes POST.
¿Puedo indicar el momento en que un usuario finaliza un proceso de contenido compartido?
No.
¿Puedo realizar publicaciones en nombre del usuario mediante programación?
No. Para hacerlo, debes pedir al usuario que inicie sesión y te conceda permisos para poder publicar en su nombre. Consulta la documentación sobre cómo realizar publicaciones con la API Graph para obtener más información.