Partage

Partage sur Messenger pour iOS et Android

Lorsque vous développez des applications avec le SDK Facebook pour iOS ou Android version 4.29.0 ou ultérieure, vous pouvez offrir à vos utilisateurs et utilisatrices la possibilité de partager des liens et du contenu multimédia sur Messenger depuis vos applications. Lors de l’utilisation de Messenger, vous pouvez déclencher vos extensions de discussion par le biais du lien d’attribution. Vos extensions de discussion s’affichent dans la section Plus de l’interface de partage.

Pour en savoir plus, consultez les sections ci-dessous :

Si vous souhaitez implémenter le partage sur Messenger pour le web, consultez la page Partage sur Messenger pour le web.

Types de partage

Le SDK Facebook offre les types de partages suivants :

  • Partage de lien (identique au partage de lien existant, mais avec un pageID pour l’attribution)
  • Photo (non attribué)

Le tableau suivant dresse la liste de tous les types de partage pris en charge dans le partage sur Messenger. Il indique également si un ID d’application ou de Page est requis.

Type de partage ID de Page requis ? Applications

Partage de lien

Facultatif

  • Lien sans attribution
  • Lien avec attribution

Photo

Non compatible

  • Photos
  • Photo de la bibliothèque

Association d’ID d’application et de Page

Les développeurs et développeuses peuvent préciser un ID de Page dans le flux de partage pour que le contenu soit attribué à la Page lorsqu’un partage du contenu sur Messenger est effectué depuis une application par le biais du SDK Sharing. De leur côté, les administrateurs et administratrices de Page peuvent éviter de fausses attributions en contrôlant quelles applications peuvent utiliser une attribution de partage pour leurs Pages. Pour accorder une attribution de partage à une application, l’administrateur ou l’administratrice associe l’ID de l’application à l’ID de la Page.

Pour associer un ID d’application à un ID de Page :

  1. Accédez aux Paramètres de la Page.
  2. Cliquez sur la section Plate-forme Messenger.
  3. Accédez à la section Associer une application dans les Paramètres généraux.
  4. Saisissez l’ID d’application et cliquez sur le bouton Associer.
  5. Si l’application N’ÉTAIT PAS encore dans le tableau Applications abonnées, elle s’affichera dans le tableau, et le rôle Attribution de partage lui sera associé. Si l’application figurait déjà dans le tableau, le nouveau rôle Attribution de partage sera ajouté pour cette application.

Les administrateurs et administratrices de Page peuvent également retirer à une application l’autorisation d’utiliser l’attribution de partage.

Pour retirer le rôle Attribution de partage à une application donnée :

  1. Dans le tableau Applications abonnées, cliquez sur le menu déroulant dans la colonne Rôle pour l’application.
  2. Cliquez sur Attribution de partage pour désélectionner ce rôle.
  3. Si Attribution de partage était le seul rôle associé à l’application, la ligne correspondante est supprimée du tableau. Sinon, la ligne est conservée, mais le rôle Attribution de partage est désélectionné.

Inscription de domaines

Si vous utilisez un bouton URL dans le SDK de partage et si vous souhaitez activer l’extension Messenger pour votre URL lorsqu’elle est ouverte dans Messenger, vous devez inscrire le domaine de l’URL pour que le partage fonctionne correctement.

Pour inscrire un domaine :

  1. Affichez la Page.
  2. Accédez à Paramètres > Messagerie avancée.
  3. Ajoutez le domaine au champ Domaines sur liste blanche.

Pour en savoir plus, consultez la section SDK Messenger Extensions : liste blanche obligatoire de domaines.

iOS

Conditions requises

Avant d’ajouter le partage sur Messenger à votre application, effectuez les étapes suivantes :

  • Ajoutez le SDK Facebook pour iOS à votre environnement de développement mobile.
  • Configurez votre ID d’application Facebook et associez-le à votre ID de Page avec l’outil Plateforme Messenger.
  • Ajoutez votre ID d’application, votre nom à l’écran et la raison (dans un format lisible) de l’accès aux photos du fichier .plist de votre application.
  • Associez le FBSDKShareKit.framework à votre projet.

Pour en savoir plus, consultez la page Démarrer avec le SDK Facebook pour iOS

Vérifiez également que votre application appelle canShow ou validate sur l’instance MessageDialog afin de déterminer si la personne dispose d’une version compatible de Messenger installée sur son appareil.

Limites

La propriété de citation n’est pas prise en charge.

Exemple de partage de lien

guard let url = URL(string: "https://newsroom.fb.com/") else {
    preconditionFailure("URL is invalid")
}

let content = ShareLinkContent()
content.contentURL = url

let dialog = MessageDialog(content: content, delegate: self)

do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Exemple de partage de photo

// Assumes your assets contain an image named "puppy"
guard let image = UIImage(named: "puppy") else {
    return
}

let photo = SharePhoto(image: image, userGenerated: true)
let content = SharePhotoContent()
        content.photos = [photo]

let dialog = MessageDialog(content: content, delegate: self)

// Recommended to validate before trying to display the dialog
do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Exemple de partage de vidéo

// Assuming you have a URL for a PHAsset
let video = ShareVideo(videoURL: assetURL)
let content = ShareVideoContent()
content.video = video

let dialog = MessageDialog(content: content, delegate: self)

// Recommended to validate before trying to display the dialog
do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Android

Conditions requises

Suivez les instructions de la page Partage sur Android, résumées ci-après :

Vérifiez également que votre application appelle MessageDialog.canshow({template}) afin de déterminer si la personne dispose d’une version compatible de Messenger installée sur son appareil.

Rubrique connexe

Partage sur Messenger pour le web