PhantomAppDevelopment / socialmedia-as3

Authenticate users from social media networks into your Adobe AIR projects. Including Facebook, Twitter and Google+

Social Media in Adobe AIR

This repository contains guides that allow your Adobe AIR applications to interact with social media networks.

This can be accomplished by just using StageWebView and URLRequest, this method doesn't require an ANE.

Some examples of what you can achieve are:

• Send a tweet on behalf the user.
• Allow the user to Like/Share your app.
• Load a user profile information (name, profile picture, email address, friend list).

Getting Started

Before you start you will require:

• A valid cellphone number. Registration in the Facebook, Twitter and Google developer portals require a cellphone number where they can confirm your account by SMS.
• The Adobe AIR SDK, preferably a recent version.
• The AS3 Crypto library.

These guides are compatible with the Apache Flex SDK, Starling Framework and pure AS3 in both Desktop and Mobile projects. The examples are provided for all 3 frameworks and are designed to be easily copied and pasted. You can access these examples with their respective guides by browsing this repository.

These guides do not work in Flash Player projects because it doesn't support the StageWebView API. If you wish to integrate social media in your Flash Player project you can do it by using their JavaScript libraries and using the ExternalInterface API.

Introduction to OAuth

The OAuth protocol allows third party applications to interact securely with private resources without exposing the logged user credentials.

The standard workflow is as follows:

1. The user wants to access some feature in your app that require a log-in.

2. The user is presented with a Sign-In button and presses it.

3. A modal window appears (Pop-Up) with a web browser inside (StageWebView) where the user must enter their username and password and allow the permissions the app requested.

4. Once the user has successfully logged in, the web browser will be redirected to a 'Success' page that will contain a token/code.

5. The app will need to grab said code and perform an URLRequest to the OAuth server where the code will be exchanged for an Access Token.

6. Once the app has gotten the Access Token, it will be used to interact with private resources, such as fetching friends lists, users profiles and more.

This workflow varies a bit on each social network, the differences will be outlined in their respective guides. Each social network guide is separated into their own folder, feel free to read them in any order.

Glossary

Name	Description
StageWebView	An Adobe AIR component that allows applications to show an embedded web browser.
URLRequest	An ActionScript 3 class for creating and sending requests to external resources, such as web servers.
App ID	A string unique to your application that identifies it to the OAuth server. Used as a parameter in a Request Token.
Scope	A parameter in a Request Token that contains the permissions the app requires.
Redirect URI/URL	A location where the StageWebView will be redirected upon a successful authorization. This location will contain a code/token that will be retrieved for creating a Token Request.
OOB	Out-of-bounds, a special OAuth parameter that indicates that a PIN-less authorization is requested.
Request Token	A string containing several parameters which will be exchanged for an Access Token.
Access Token	An alphanumeric string that is used as a parameter in URLRequests to access private resources.

Donations

Feel free to support the development of free guides and examples. Your donations are greatly appreciated.