FBStartSession (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / Facebook functions

Starting the session
Characteristics of the session
Closing the session
Incompatibility between the IE ActiveX (and oAuth2) and the use .NET assemblies
Background application: Specific to Android 10 and higher

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

FBStartSession (Function)

In french: FBOuvreSession

Used to authenticate and log in to Faceboook.

This function is not available in the simulator.

Attention: This feature is available until Android 11. Starting with Android 12, this function causes a fatal error.
We advise you to:

use SysAndroidVersion to test the Android version used.
use AuthIdentify to manage Facebook authentication.

Example

MySession is fbSession
MySession.AppID = "1702546803104741"
MySession.AppSecret = "badf00ddeadbeefbadc0deoff1ce8ecd"
MySession.Permission = [fbInfoProfile, fbEmail]
IF FBStartSession(MySession) THEN
	Info("Connected")
END

Syntax

Synchronous authentication Hide the details

<Result> = FBStartSession(<Session>)

<Result>: Boolean

True if the connection was established,
False otherwise.

<Session>: fbSession variable

Name of the fbSession variable corresponding to the connection to initialize.

Asynchronous authentication Hide the details

FBStartSession(<Session> , <WLanguage procedure>)

<Session>: fbSession variable

Name of the fbSession variable corresponding to the connection to initialize.

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure ("callback") called during the connection. This procedure has the following format:
<Procedure name>(Connection, Session)
where:
<Connection> is set to:
True if the connection was established,
False otherwise.
<Session> is a variable of type fbSession that corresponds to the initialized connection.

Remarks

Starting the session

FBStartSession authenticates users on a Facebook server. This function initializes the connection with the server and must be called before any interaction with Facebook.
A login window appears automatically.
The function uses the Facebook account entered by the user on the phone (if it is specified).
A single session can be started at a time. If FBStartSession is called while a session is already open, the previous session will be closed.
The FBStartSession function must only be called from the main the thread of the application.

Characteristics of the session

The "public_profile" permission is always required when starting a Facebook session. If this permission was not specified in the list of permissions for the fbSession variable passed as parameter to FBStartSession, it will be automatically requested.

Closing the session

An open Facebook session is persistent: it will remain open:

until the application is closed.
until FBStopSession is called.

Incompatibility between the IE ActiveX (and oAuth2) and the use .NET assemblies

When an HTML control is used in WINDEV, this control uses the "Microsoft Web browser" ActiveX system. ActiveX is also used by WINDEV for all OAuth2 authentications (Facebook, Twitter, Google, etc.) that require a validation for the connection via HTML code.

If you use an HTML control (or OAuth2 authentication) and a ".Net" assembly in the same project, you may encounter a compatibility issue between Microsoft .NET layers and the ActiveX framework.

An API can be used to manage both technologies. To do so, write the following line of code in the initialization code of the project or in the initialization code of a class or global procedure if the ".Net" object is initialized in a class or in a set of procedures:

// Used to manage the cohabitation between IE ActiveX and .NET
API("OLE32", "CoInitializeEx", Null, 2)

Background application: Specific to Android 10 and higher

Starting with Android 10, it is no longer possible to open a window when the application is in the background.

FBStartSession can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

It is possible to determine if the application is in the background using InBackgroundMode.
If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

For more details, see Android 10: Application behavior in the background.

Business / UI classification: Business Logic

Component: wd300ggl.dll