DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions Facebook
  • Ouverture de la session
  • Caractéristiques de la session
  • Fermeture de la session
  • Incompatibilité entre l'ActiveX IE (et oAuth2) et l'utilisation d'assemblage .NET
  • Application en arrière-plan : Spécificité à partir de Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Permet l'authentification et la connexion à Facebook.
AndroidiPhone/iPadWidget IOSMac Catalyst Cette fonction n'est pas disponible dans le simulateur.
Android Attention : Cette fonctionnalité est disponible jusqu'à Android 11. A partir d'Android 12, cette fonction provoque une erreur fatale.
Il est conseillé de :
  • tester la version d'Android utilisée via la fonction SysVersionAndroid.
  • utiliser la fonction AuthIdentifie pour gérer l'authentification Facebook.
Exemple
MaSession est une fbSession
MaSession.AppID = "1702546803104741"
MaSession.AppSecret = "badf00ddeadbeefbadc0deoff1ce8ecd"
MaSession.Permission = [fbInfoProfil, fbEmail]
SI FBOuvreSession(MaSession) ALORS
Info("Connecté")
FIN
Syntaxe

Authentification synchrone Masquer les détails

<Résultat> = FBOuvreSession(<Session>)
<Résultat> : Booléen
  • Vrai si la connexion a réussi,
  • Faux dans le cas contraire.
<Session> : Variable de type fbSession
Nom de la variable de type fbSession correspondant à la connexion à initialiser.
WINDEVWEBDEV - Code ServeurLinuxiPhone/iPadWidget IOSMac Catalyst

Authentification asynchrone Masquer les détails

FBOuvreSession(<Session> , <Procédure WLangage>)
<Session> : Variable de type fbSession
Nom de la variable de type fbSession correspondant à la connexion à initialiser.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (également nommée "callback") appelée lors de la connexion. Cette procédure est de la forme :
<Nom de la procédure>(Connexion, Session)
où :
  • <Connexion> vaut :
    • Vrai si la connexion a réussi,
    • Faux dans le cas contraire.
  • <Session> est une variable de type fbSession correspondant à la connexion initialisée.
Remarques

Ouverture de la session

  • La fonction FBOuvreSession permet de s'authentifier auprès d'un serveur Facebook. Cette fonction initialise la connexion avec le serveur et doit être appelée avant toute communication avec Facebook.
  • WINDEV Une fenêtre permettant à l'utilisateur de saisir son login et son mot de passe est automatiquement ouverte.
  • iPhone/iPadWidget IOSMac Catalyst La fonction utilise par défaut le compte Facebook entré par l'utilisateur sur le téléphone (si ce compte est fourni).
  • Android Il est possible d'ouvrir une seule session à la fois. Si la fonction FBOuvreSession est appelée alors qu'une session est déjà ouverte, la session précédente sera fermée.
  • La fonction FBOuvreSession doit être appelée uniquement depuis le thread principal de l'application.
Android

Caractéristiques de la session

La permission "public_profile" est toujours requise lors de l'ouverture d'une session Facebook. Si cette permission n'a pas été spécifiée dans la liste des permissions de la variable fbSession passée en paramètre à la fonction FBOuvreSession, cette permission sera automatiquement demandée.

Fermeture de la session

Une session Facebook ouverte est persistante : elle restera ouverte :
  • jusqu'à la fermeture de l'application.
  • jusqu'à l'utilisation de la fonction FBFermeSession.
WINDEV

Incompatibilité entre l'ActiveX IE (et oAuth2) et l'utilisation d'assemblage .NET

Lorsque vous utilisez un champ HTML dans WINDEV, ce champ utilise l'ActiveX système "Navigateur Web Microsoft". Cet ActiveX est également utilisé par WINDEV pour toutes les authentifications OAuth2 (Facebook, Twitter, Google, etc) qui demandent une validation pour la connexion via du code HTML.
Si dans un même projet vous utilisez un champ HTML (ou une authentification OAuth2) et un assemblage ".Net", vous risquez de rencontrer une incompatibilité entre les couches .NET de Microsoft et l'ActiveX.
Il existe une API qui permet de gérer cette cohabitation. Pour cela vous devez utiliser la ligne de code suivante dans le code d'initialisation du projet ou dans le code d'initialisation de classes ou de procédure globale si l'initialisation de l'objet ".Net" est faite dans la classe ou la collection de procédure :
// Permet de gérer la cohabitation de l'ActiveX IE et de .NET
API("OLE32", "CoInitializeEx", Null, 2)
Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction FBOuvreSession peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Classification Métier / UI : Code métier
Composante : wd290ggl.dll
Version minimum requise
  • Version 21
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 21/12/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale