Compartilhamento para dispositivos

Com o Compartilhamento para Dispositivos, as pessoas podem compartilhar com facilidade o conteúdo de dispositivos para o Facebook. Isso inclui Smart TVs, molduras digitais ou dispositivos da Internet das Coisas.

Com o compartilhamento de dispositivos, o dispositivo mostra um código alfanumérico e diz às pessoas para inseri-lo em uma página da Web no computador ou smartphone. As pessoas que usam seu aplicativo ou serviço podem então compartilhar conteúdo com o Facebook com um diálogo de compartilhamento associado ao código.

Se você estiver comprando um aplicativo para Apple TV ou dispositivos Android, você deve usar nosso SDK para tvOS ou SDK para Android, respectivamente.

Este guia descreve o seguinte:

Experiência do usuário

1. Chamada para ação

Primeiro, considere em que momento da experiência do usuário você quer pedir às pessoas para compartilhar o conteúdo com o Facebook. Para garantir a melhor experiência, crie o botão para ser o mais parecido possível com o botão oficial Compartilhar do Facebook. Em geral, o botão deve ficar próximo ao conteúdo a ser compartilhado.

De uma perspectiva de design visual, isso significa que você deve

  1. Rotule o botão com "Compartilhar" ou “Compartilhar no Facebook”.
  2. Use branco e o azul oficial da marca Facebook: #3B5998.
  3. Se o dispositivo suporta visualização gráfica, também é possível incorporar o logotipo oficial "f". De acordo com as diretrizes da marca do Facebook, o logotipo deve ser sempre branco ou azul Facebook (# 3B5998).

2. Exibir o código

Quando alguém clica na chamada para ação, o dispositivo faz uma chamada para a API do Facebook que retorna um código.

Em sua interface, diga às pessoas que elas precisam visitar um site e inserir o código com a seguinte mensagem: "Em seguida, visite facebook.com/device (http://facebook.com/device) em seu computador ou smartphone e insira este código". Exiba o código completo que você recebeu da API de Compartilhamento de Dispositivos do Facebook. O código tem entre 6 e 12 caracteres.

Inclua um botão Close ou Done para que as pessoas possam concluir o fluxo de Compartilhamento de Dispositivos.

3. Compartilhamento

É o fluxo visto pelos usuários quando eles acessam facebook.com/device no computador ou navegador móvel. Primeiro eles veem um campo de texto onde podem inserir o código:

Depois de inserir o código e clicar em Continue, eles verão um Diálogo de compartilhamento:

Para que as pessoas saibam que o compartilhamento foi bem-sucedido, elas recebem uma mensagem de confirmação:

Implementar o Compartilhamento para Dispositivos

O Compartilhamento para Dispositivos do Facebook é para dispositivos que podem fazer chamadas HTTP através da Internet. A seguir estão as chamadas de API e as respostas que seu dispositivo pode dar.

1. Habilitar o Login para Dispositivos

Carregue o painel de seu aplicativo e altere Configurações > Avançadas > Configurações de OAuth > Login de Dispositivos para "Sim".

2. Gerar um código

Quando a pessoa clicar na chamada para ação Share, seu dispositivo deverá fazer um HTTP POST para:

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

O CLIENT_TOKEN encontra-se em suas Configurações do aplicativo -> Avançadas, e deve ser combinado com o número de identificação do seu aplicativo (separado por uma barra vertical, |) para formar o access_token completo.

A API também é compatível com action_type e action_properties, em vez de href, se você quiser compartilhar uma história do Open Graph (da mesma forma que as ações do Open Graph no Diálogo de compartilhamento).

A API também é compatível com os parâmetros quote e hashtag (da mesma forma que os parâmetros do Diálogo de compartilhamentos.

A resposta é desta forma:

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

Esta resposta significa:

  1. Exibir a cadeia de caracteres "A1NWZ9" no seu dispositivo.
  2. Dizer à pessoa para acessar "facebook.com/device" e inserir este código.
  3. O código expira em 420 segundos. Você deve fechar a exibição do código após esse tempo.

3. Exibir o código

O dispositivo deve apresentar o user_code e dizer às pessoas para visitar a verification_uri como facebook.com/device no PC ou smartphone. Consulte Experiência do usuário.

Solução de problemas

Posso fazer solicitações de fluxo do dispositivo por meio de HTTP?
A Graph API com tokens requer TLS/HTTPS.

Posso fazer solicitações de fluxo do dispositivo com o método GET?
Todas as solicitações de fluxo do dispositivo devem ser solicitações POST.

Há como saber quando a pessoa concluiu um compartilhamento?
Não.

Posso publicar em nome da pessoa de forma programática?
Não. Para fazer isso, você deve pedir ao usuário para entrar e conceder permissões para você publicar em nome dele. Consulte publicar com a Graph API para saber mais.