Flash Facebook Cookbook

Table of Contents

Flash Facebook Cookbook

Credits

About the Author

Acknowledgement

About the Reviewers

www.PacktPub.com

Support files, eBooks, discount offers, and more

Why Subscribe?

Free Access for Packt account holders

Preface

What this book covers

What you need for this book

Who this book is for

Conventions

Reader feedback

Customer support

Downloading the example code for this book

Errata

Piracy

Questions

1. Getting Started with Flash and Facebook

Introduction

Setting up a new application on Facebook

Getting ready

How to do it...

How it works...

There's more...

See also

Downloading the Facebook ActionScript 3 SDK

Getting ready

How to do it...

How it works...

There's more

The Flash Player version, or the AIR version of the SDK?

What if I want to build my own Facebook library?

See also

Including the Facebook ActionScript 3 SDK in a Flash Builder project

How to do it...

How it works...

There's more...

Linking source files to an included SWC

See also

Including the Facebook ActionScript 3 SDK as a Flash Builder library project

How to do it...

How it works...

There's more...

See also

Preparing your Flash Player application's HTML template for Facebook integration

Getting ready

How to do it...

How it works...

There's more

Testing and debugging our Flash Builder project locally

Where can users access our Facebook application from?

Setting up a Canvas or Tab application on Facebook.com

Working without the JavaScript SDK?

See also

2. Authenticating with Facebook

Introduction

It's all about Access tokens

Authentication with the Web SDK, for Flash Player applications

Getting ready

How to do it...

How it works...

There's more...

Automatic authentication with Facebook

When should we launch the Login Dialog?

The options parameter

See also

Authentication with the Desktop SDK, for AIR applications

Getting ready

How to do it...

How it works...

There's more...

How does the pop-up window work?

See also

Logging out of Facebook

Getting ready

How to do it...

How it works...

There's more...

See also

Retrieving information about the current session and active Facebook user

Getting ready

How to do it...

How it works...

There's more...

Problems with the available permissions or the user object?

See also

Reacting to external session changes and JavaScript events

Getting ready

How to do it...

How it works...

There's more...

Other events from Facebook

Is your user connected, not connected, or unknown?

See also

3. Working with Facebook Permissions

Introduction

Requesting permissions at login

Getting ready

How to do it...

How it works...

There's more...

Using the ExtendedPermission class, instead of using hardcoded permission names

See also

Checking for existing Extended Permissions

Getting ready

How to do it...

How it works...

There's more...

Using the ExtendedPermission class constants to generate our FQL request

What about FacebookSession.availablePermissions?

See also

Requesting additional Extended Permissions, following a failed API request

Getting ready

How to do it...

How it works...

There's more...

Checking if a failed API request is caused by (a lack of) Extended Permissions

See also

Pre-emptively requesting additional Extended Permissions

Getting ready

How to do it...

How it works...

There's more...

See also

4. Reading and Writing Data with the Graph API

Introduction

Building a 'Test console' for the Graph API

Getting ready

How to do it...

How it works...

There's more...

Using an animation to indicate load progress

Getting a human-readable JSON string from the API

See also

Loading a Graph API object from Facebook

Getting ready

How to do it...

How it works...

There's more...

Converting raw results into ActionScript class instances

Detecting errors in Graph API requests

Usernames and Vanity URLs

Using the 'me' shortcut to reference the current user

/[OBJECT_ID] vs. [OBJECT_ID] in requests

See also

Loading specific data fields for a Graph API object

Getting ready

How to do it...

How it works...

There's more...

The undocumented fringes of the Graph API

See also

Loading Graph API connections

Getting ready

How to do it...

How it works...

There's more...

Handling responses with mixed results content types

See also

Loading multiple Graph API objects, in a single request

How to do it...

How it works...

There's more...

See also

Limiting request lengths and paging results

Getting ready

How to do it...

How it works...

There's more...

See also

Filtering requests to a specific time period

How to do it...

How it works...

There's more...

See also

Loading a Facebook profile image

How to do it...

How it works...

There's more...

Getting image URLs from Graph API objects

GetImageURL and the 'me' shortcut

See also

Using the search capabilities of the Graph API

Getting ready

How to do it...

How it works...

There's more...

See also

Creating, editing, and deleting Graph API objects

Getting ready

How to do it...

How it works...

There's more...

See also

5. Loading Data with FQL

Introduction

Loading data with FQL

Getting ready

How to do it...

How it works...

There's more...

Formatting (pretty-printing) our FQL requests

Using the FQL name classes to construct requests

Using me() to reference the current user

See also

Using subqueries in FQL

How to do it...

How it works...

There's more...

Loading the current user's family

Loading a list of users that have been tagged in photos, alongside the current user

Advanced data types in FQL

See also

Using logical operators in FQL requests

Getting ready

How to do it...

How it works...

There's more...

Removing the current user from the results

Excluding results with 'NOT IN'?

See also

Loading large data sets with FQL multiquery

Getting ready

How to do it...

How it works...

There's more...

What's faster?

See also

Cross-comparing data sets to find overlapping results

Getting ready

How to do it...

How it works...

There's more...

Why use server-side comparisons?

See also

Sorting FQL results

Getting ready

How to do it...

How it works...

There's more...

Case-insensitive sorting

Sorting results with advanced objects

See also

Limiting and paging FQL results

Getting ready

How to do it...

How it works...

There's more...

Should we add limits to FQL requests?

See also

Searching for text strings in FQL

Getting ready

How to do it...

How it works...

There's more...

See also

6. Facebook News Feeds and Status Updates

Introduction

Loading a user's status updates

Getting ready

How to do it...

How it works...

There's more...

Displaying the time since on status updates

Extracting and highlighting links in status updates

See also

Creating a status update with ActionScript

Getting ready

How to do it...

How it works...

There's more...

Posting status updates to other user's walls.

Privacy settings and status updates—who can see your updates?

See also

Posting a link with ActionScript

Getting ready

How to do it...

How it works...

There's more...

Publishing internal links to a Canvas application

See also

Deleting a status update with ActionScript

Getting ready

How to do it...

How it works...

There's more...

See also

Adding custom actions to Facebook posts

How to do it...

How it works...

There's more...

Working with query strings and responding to custom actions

See also

7. Comments and Like this

Introduction

Loading Comments for a Graph API object

Getting ready

How to do it...

How it works...

There's more...

What type of objects can have Comments?

See also

Adding a Comment to a Graph API object

Getting ready

How to do it...

How it works...

There's more...

Comments and privacy settings

See also

Deleting a Comment

Getting ready

How to do it...

How it works...

There's more...

Knowing which comments can be deleted by the current user

See also

Retrieving Likes for a Graph API object

Getting ready

How to do it...

How it works...

There's more...

No Likes? Make sure you're using the object ID

See also

Adding a Like to a Graph API object

Getting ready

How to do it...

How it works...

There's more...

Removing a Like from Graph API object

See also

Retrieving a Like count for a specified URL

How to do it...

Retrieving URL statistics with the Graph API

Retrieving URL statistics with FQL

How it works...

There's more...

Requesting statistics for the current page URL

Requesting statistics for multiple URLs

Ensuring correct URL encoding for the Graph API

See also

8. Working with Photos, Albums, and Tags

Introduction

Retrieving Photo and Album information from Facebook

Getting ready

How to do it...

How it works...

There's more...

Loading Photos, without selecting an Album first

See also

Loading and displaying Photo Tags

Getting ready

How to do it...

How it works...

There's more...

Creating an Album with the Graph API

Getting ready

How to do it...

How it works...

There's more...

Uploading Photos to Facebook

Getting ready

How to do it...

How it works...

There's more...

Uploading Webcam or generated images to Facebook

Adding a message to uploaded images

See also

9. Working with Groups and Events

Introduction

Retrieving Facebook Group information

Getting ready

How to do it...

How it works...

There's more...

Loading the current user's Groups

See also

Retrieving Group membership information

Getting ready

How to do it...

How it works...

There's more...

See also

Retrieving Facebook Events information

Getting ready

How to do it...

How it works...

There's more...

Understanding and formatting time information from Facebook

Plotting Events on a Map

Getting ready

How to do it...

How it works...

There's more...

See also

Loading Event RSVP statuses

Getting ready

How to do it...

How it works...

There's more...

See also

Changing current user's RSVP status

Getting ready

How to do it...

How it works...

See also

Creating an Event on the user's behalf

Getting ready

How to do it...

How it works...

There's more...

See also

Inviting friends to an Event

Getting ready

How to do it...

How it works...

10. Checkins and Facebook Places

Introduction

Downloading and integrating the Google Maps API

How to do it...

Retrieving Checkin information for the current user and their friends

Getting ready

How to do it...

How it works...

There's more...

Finding the user's most recent Checkin

Exploring Checkins at a specific Place

Finding Facebook Places near a specific location

Getting ready

How to do it...

How it works...

There's more...

Searching for Places within a specific distance

Creating and using custom Map Markers for our Places

See also

Integrating with HTML5 geolocation capabilities, Maps, and Facebook Places

Getting ready

How to do it...

How it works...

There's more...

Dealing with Geolocation errors

Using an overlay to represent geolocation accuracy

Working with the native Flash Platform Geolocation capabilities

See also

Creating new Checkins at an existing Facebook Place

Getting ready

How to do it...

How it works...

There's more...

Adding a message to a Checkin

Tagging other users to include them in a Checkin

See also

11. Bridging the Flash and Application Gap

Introduction

Launching Facebook UI dialogs from ActionScript 3

Getting ready

How to do it...

How it works...

There's more...

The display mode: Launching dialogs as inline iframes or new browser windows

See also

Imitating the Facebook.com UI in Flex

How to do it...

How it works...

There's more...

Displaying a Facebook-style loading indicator

Getting ready

How to do it...

How it works...

There's more...

Adding a text message to the loading animation

Creating the ApplicationBase class

Getting ready

How to do it...

How it works...

There's more...

Using the ApplicationBase class, instead of the standard Application class

Specifying Extended Permission requirements in our recipes

Automatically executing code once our application is authenticated with Facebook

See also

Index

Flash Facebook Cookbook

Flash Facebook Cookbook

Copyright © 2011 Packt Publishing

All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.

Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the author, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book.

Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information.

First published: August 2011

Production Reference: 1170811

Published by Packt Publishing Ltd.

Livery Place

35 Livery Street

Birmingham B3 2PB, UK

ISBN 978-1-849690-72-0

www.packtpub.com

Cover Image by Charwak A. (<charwak86@gmail.com>)

Credits

Author

James Ford

Reviewers

Emanuele Feronato

Paulius Uza

Acquisition Editor

Steven Wilding

Development Editor

Hyacintha D’Souza

Technical Editors

Prashant Macha

Gauri Iyer

Sakina Kaydawala

Project Coordinator

Leena Purkait

Proofreader

Lynda Silwoski

Indexer

Monica Ajmera Mehta

Production Coordinator

Shantanu Zhagade

Cover Work

Shantanu Zhagade

About the Author

James Ford lives and works in the relatively sedate Midlands of England, and is constantly thankful that he doesn’t have to contend with public transport or large volumes of traffic on a regular basis. Occasionally being stuck behind a tractor for several miles is a small price to pay for that!

Macromedia Flash 8 represented his first serious interaction with a programming language, an epiphany whereupon his BA in Design for Interactive Media became far more focused on the Programming side of things than the Art (although it turned out okay).

He considers himself to be fortunate to have encountered the Flash Platform when he did, as during that time between first contact and today, the Flash Platform has evolved at just the right pace to enable him to keep up with the latest shiny new features.

In addition to developing Facebook-integrated Flash Player applications, James has also developed a few AIR applications, built a couple of Apps for iOS and Android devices, helped develop a load of websites, and blogs about all of this on his website: http://www.psyked.co.uk/.

Acknowledgement

So much of what seems original in the world of programming can be achieved by simply learning to use the tools that others have already developed, and the code that we use in this cookbook does a lot of just that. With this in mind, we should acknowledge the authors of the two main Facebook ActionScript libraries:

Jason Christ, the team from http://gskinner.com/ and the teams at both Adobe and Facebook, who have collaborated to produce the Official Facebook ActionScript 3 SDK.

Mark Walters, a.k.a. yourpalmark, who almost singlehandedly extended the Official SDK into the unofficial community-supported SDK, introducing a more frequent update schedule and a range of helpful new ActionScript classes. It’s his version of the SDK that we use in this cookbook, and I’m very grateful for it.

Thanks also to my technical reviewers, Emanuele and Paul, whose comments have been invaluable—keeping my propensity for bad coding practice in check as much as everything else, I hope it wasn’t too harrowing a task for you guys.

And of course, the team at Packt Publishing—particulary Steven, Hyacintha, and Leena—and everyone else who’s been involved. No doubt that I could not have done it without you.

About the Reviewers

Emanuele Feronato has been studying programming languages since the early eighties, with a particular interest in web and game development. He taught online programming for the European Social Fund and now owns a web development company in Italy where he also works as a lead programmer.

As a writer, he has worked as technical reviewer for Packt Publishing and he’s actually writing a book about Flash game development.

His blog, www.emanueleferonato.com, is one of the most visited blogs about indie programming.

I would like to thank Leena Purkait at Packt Publishing for the opportunity to review this book, and my little daughter Kimora for making my life happy.

Paulius Uza is an award winning Interactive Producer and Managing Partner at InRuntime Inc. Over the last nine years, Paulius has gained significant experience in various fields of digital advertising and technology by working with a world renowned brands such as MTV, Nokia, ZuluTrade, AAAFx, and Donzi Marine to name a few. Being an artist and a technology expert, Paulius combines best of both worlds by creating and delivering engaging digital advertising and interactive media experiences.

Paulius is a major contributor to open source community, with his software featured in hundreds of open source and commercial software projects such as Adobe Captivate.

During his free time he writes a blog about interactive design and programming topics at: http://www.uza.lt

www.PacktPub.com

Support files, eBooks, discount offers, and more

You might want to visit www.PacktPub.com for support files and downloads related to your book.

Did you know that Packt offers eBook versions of every book published, with PDF and ePub files available? You can upgrade to the eBook version at www.PacktPub.com and as a print book customer, you are entitled to a discount on the eBook copy. Get in touch with us at for more details.

At www.PacktPub.com, you can also read a collection of free technical articles, sign up for a range of free newsletters and receive exclusive discounts and offers on Packt books and eBooks.

http://PacktLib.PacktPub.com

Do you need instant solutions to your IT questions? PacktLib is Packt's online digital book library. Here, you can access, read, and search across Packt's entire library of books.

Why Subscribe?

Fully searchable across every book published by Packt

Copy and paste, print and bookmark content

On demand and accessible via web browser

Free Access for Packt account holders

If you have an account with Packt at www.PacktPub.com, you can use this to access PacktLib today and view nine entirely free books. Simply use your login credentials for immediate access.

This book is dedicated to Leonie; my soulmate, my better half. She’s been infinitely patient and supportive, both before and during the writing of this cookbook. Couldn’t have done it without you, you know.

Family and friends deserve credit also—encouragement and support is very warmly received. I apologize profoundly for being distant and unreachable for so long while I’ve been writing.

Preface

Flash applications are popular and becoming increasingly social. With Flash applications for Facebook you can tap into a potential audience of half a billion existing users, their connections and affiliations, their uploaded images, posts, comments, and more.

The Flash Facebook Cookbook is packed with recipes for the Graph API and FQL, used for reading and writing data as well as interacting with Facebook anonymously or on behalf of an authorized Facebook User.

The topics covered by the recipes in this cookbook include working with News Feeds, uploading Photos, searching for and plotting Places on a Map and much more. The cookbook has recipes ranging from those that work without any authentication with Facebook to those that do, and act on behalf of a user. Packed with recipes that yield practical demonstrations of the Graph API functionality, the Flash Facebook Cookbook is an essential tool for Flash Platform developers.

What this book covers

Chapter 1, Getting Started with Flash and Facebook: This chapter deals with downloading the Facebook ActionScript 3 SDK, registering a new Application on Facebook.com, getting your Flash Builder development environment set up, and getting ready to start working with the Facebook APIs.

Chapter 2, Authenticating with Facebook: Our application can't do much unless it's first authenticated with Facebook, so this chapter covers logging in, logging out, and tapping into existing Facebook sessions, for both Flash Player and AIR-based projects.

Chapter 3, Working with Facebook Permissions: Even authenticated, our application can't do much without the correct permissions, so this chapter covers processes, tactics, and strategies for working with and requesting those Extended Permissions for Facebook users.

Chapter 4, Reading and Writing Data with the Graph API: A generalized introduction to working with the core Graph API, including retrieving specific objects, multiple objects, and object connections; searching for data, limiting and paging results; and an introduction to creating and managing data with the Graph API.

Chapter 5, Loading Data with FQL: FQL is the SQL-like syntax for retrieving data from Facebook, and with it we can retrieve far more specific data than we can with the Graph API, including data that is unavailable via the Graph API.

Chapter 6, Facebook News Feeds and Status Updates: In this chapter, we look at loading Facebook News and Profile Feeds, creating new Status updates and Links, and adding custom actions to links to help promote your Facebook application.

Chapter 7, Comments and Like this: Following on from the previous chapter, we look at loading, creating, and deleting Comments for Graph API objects, and the same for 'Likes', with both Graph API objects and web URLs.

Chapter 8, Working with Photos, Albums, and Tags: In this chapter, we'll load Photos from the Graph API—both photos of the current user, and photos from the current user. We display these images and overlay Facebook tagging information, and use the Flash Player to upload new images on the user's behalf.

Chapter 9, Working with Groups and Events: In this chapter, we retrieve Facebook Group and Event information, locate them on a Map, create new Events, and respond to Event invitations on the user's behalf.

Chapter 10, Checkins with Facebook Places: In this chapter, we download and integrate the Google Maps components and use them to plot Checkins and Facebook Places. We work with the Geolocation capabilities of HTML5, and use them to search for nearby Facebook Places and create new Checkins.

Chapter 11, Bridging the Flash and Application Gap: Finally, we'll look to improve the integration between your application and Facebook—imitate the Facebook.com website interface, use native dialogs to bypass the need for Extended Permissions, and develop a new class to simplify the authentication and permissions management for our application.

What you need for this book

Software:

Adobe Flash Builder 4 (or greater), with the Flex 4 SDK and AIR libraries

A web browser (obviously)

Additional hardware/software:

(Access to) an HTTP web server, either online or local

Who this book is for