WAFbImpl.git - Gitblit

			@@ -22,21 +22,21 @@

			@class FBSDKLoginManagerLoginResult;

			/*!
			@abstract Describes the call back to the FBSDKLoginManager
			@param result the result of the authorization
			@param error the authorization error, if any.
			/**
			Describes the call back to the FBSDKLoginManager
			- Parameter result: the result of the authorization
			- Parameter error: the authorization error, if any.
			*/
			typedef void (^FBSDKLoginManagerRequestTokenHandler)(FBSDKLoginManagerLoginResult result, NSError error);


			/*!
			@typedef FBSDKDefaultAudience enum
			/**
			FBSDKDefaultAudience enum

			@abstract
			Passed to open to indicate which default audience to use for sessions that post data to Facebook.
			Passed to open to indicate which default audience to use for sessions that post data to Facebook.

			@discussion


			Certain operations such as publishing a status or publishing a photo require an audience. When the user
			grants an application permission to perform a publish operation, a default audience is selected as the
			publication ceiling for the application. This enumerated value allows the application to select which
			@@ -44,21 +44,21 @@
			*/
			typedef NS_ENUM(NSUInteger, FBSDKDefaultAudience)
			{
			/! Indicates that the user's friends are able to see posts made by the application /
			/** Indicates that the user's friends are able to see posts made by the application */
			FBSDKDefaultAudienceFriends = 0,
			/! Indicates that only the user is able to see posts made by the application /
			/** Indicates that only the user is able to see posts made by the application */
			FBSDKDefaultAudienceOnlyMe,
			/! Indicates that all Facebook users are able to see posts made by the application /
			/** Indicates that all Facebook users are able to see posts made by the application */
			FBSDKDefaultAudienceEveryone,
			};

			/*!
			@typedef FBSDKLoginBehavior enum
			/**
			FBSDKLoginBehavior enum

			@abstract
			Passed to the \c FBSDKLoginManager to indicate how Facebook Login should be attempted.
			Passed to the \c FBSDKLoginManager to indicate how Facebook Login should be attempted.

			@discussion


			Facebook Login authorizes the application to act on behalf of the user, using the user's
			Facebook account. Usually a Facebook Login will rely on an account maintained outside of
			the application, by the native Facebook application, the browser, or perhaps the device
			@@ -71,24 +71,24 @@
			*/
			typedef NS_ENUM(NSUInteger, FBSDKLoginBehavior)
			{
			/*!
			@abstract This is the default behavior, and indicates logging in through the native
			/**
			This is the default behavior, and indicates logging in through the native
			Facebook app may be used. The SDK may still use Safari instead.
			*/
			FBSDKLoginBehaviorNative = 0,
			/*!
			@abstract Attempts log in through the Safari or SFSafariViewController, if available.
			/**
			Attempts log in through the Safari or SFSafariViewController, if available.
			*/
			FBSDKLoginBehaviorBrowser,
			/*!
			@abstract Attempts log in through the Facebook account currently signed in through
			/**
			Attempts log in through the Facebook account currently signed in through
			the device Settings.
			@note If the account is not available to the app (either not configured by user or
			as determined by the SDK) this behavior falls back to \c FBSDKLoginBehaviorNative.
			*/
			FBSDKLoginBehaviorSystemAccount,
			/*!
			@abstract Attemps log in through a modal \c UIWebView pop up
			/**
			Attempts log in through a modal \c UIWebView pop up

			@note This behavior is only available to certain types of apps. Please check the Facebook
			Platform Policy to verify your app meets the restrictions.
			@@ -96,100 +96,106 @@
			FBSDKLoginBehaviorWeb,
			};

			/*!
			@abstract `FBSDKLoginManager` provides methods for logging the user in and out.
			@discussion `FBSDKLoginManager` works directly with `[FBSDKAccessToken currentAccessToken]` and
			/**
			`FBSDKLoginManager` provides methods for logging the user in and out.

			`FBSDKLoginManager` works directly with `[FBSDKAccessToken currentAccessToken]` and
			sets the "currentAccessToken" upon successful authorizations (or sets `nil` in case of `logOut`).

			You should check `[FBSDKAccessToken currentAccessToken]` before calling logIn* to see if there is
			a cached token available (typically in your viewDidLoad).

			If you are managing your own token instances outside of "currentAccessToken", you will need to set
			"currentAccessToken" before calling logIn* to authorize futher permissions on your tokens.
			"currentAccessToken" before calling logIn* to authorize further permissions on your tokens.
			*/
			@interface FBSDKLoginManager : NSObject

			/*!
			@abstract the default audience.
			@discussion you should set this if you intend to ask for publish permissions.
			/**
			the default audience.

			you should set this if you intend to ask for publish permissions.
			*/
			@property (assign, nonatomic) FBSDKDefaultAudience defaultAudience;

			/*!
			@abstract the login behavior
			/**
			the login behavior
			*/
			@property (assign, nonatomic) FBSDKLoginBehavior loginBehavior;

			/*!
			@deprecated use logInWithReadPermissions:fromViewController:handler: instead
			/**

			- Warning:use logInWithReadPermissions:fromViewController:handler: instead
			*/
			- (void)logInWithReadPermissions:(NSArray *)permissions handler:(FBSDKLoginManagerRequestTokenHandler)handler
			__attribute__ ((deprecated("use logInWithReadPermissions:fromViewController:handler: instead")));

			/*!
			@deprecated use logInWithPublishPermissions:fromViewController:handler: instead
			/**

			- Warning:use logInWithPublishPermissions:fromViewController:handler: instead
			*/
			- (void)logInWithPublishPermissions:(NSArray *)permissions handler:(FBSDKLoginManagerRequestTokenHandler)handler
			__attribute__ ((deprecated("use logInWithPublishPermissions:fromViewController:handler: instead")));

			/*!
			@abstract Logs the user in or authorizes additional permissions.
			@param permissions the optional array of permissions. Note this is converted to NSSet and is only
			/**
			Logs the user in or authorizes additional permissions.
			- Parameter permissions: the optional array of permissions. Note this is converted to NSSet and is only
			an NSArray for the convenience of literal syntax.
			@param fromViewController the view controller to present from. If nil, the topmost view controller will be
			- Parameter fromViewController: the view controller to present from. If nil, the topmost view controller will be
			automatically determined as best as possible.
			@param handler the callback.
			@discussion Use this method when asking for read permissions. You should only ask for permissions when they
			- Parameter handler: the callback.

			Use this method when asking for read permissions. You should only ask for permissions when they
			are needed and explain the value to the user. You can inspect the result.declinedPermissions to also
			provide more information to the user if they decline permissions.

			If `[FBSDKAccessToken currentAccessToken]` is not nil, it will be treated as a reauthorization for that user
			and will pass the "rerequest" flag to the login dialog.

			This method will present UI the user. You typically should check if `[FBSDKAccessToken currentAccessToken]`
			already contains the permissions you need before asking to reduce unnecessary app switching. For example,
			you could make that check at viewDidLoad.
			You can only do one login call at a time. Calling a login method before the completion handler is called
			on a previous login will return an error.
			*/
			- (void)logInWithReadPermissions:(NSArray *)permissions
			fromViewController:(UIViewController *)fromViewController
			handler:(FBSDKLoginManagerRequestTokenHandler)handler;

			/*!
			@abstract Logs the user in or authorizes additional permissions.
			@param permissions the optional array of permissions. Note this is converted to NSSet and is only
			/**
			Logs the user in or authorizes additional permissions.
			- Parameter permissions: the optional array of permissions. Note this is converted to NSSet and is only
			an NSArray for the convenience of literal syntax.
			@param fromViewController the view controller to present from. If nil, the topmost view controller will be
			- Parameter fromViewController: the view controller to present from. If nil, the topmost view controller will be
			automatically determined as best as possible.
			@param handler the callback.
			@discussion Use this method when asking for publish permissions. You should only ask for permissions when they
			- Parameter handler: the callback.

			Use this method when asking for publish permissions. You should only ask for permissions when they
			are needed and explain the value to the user. You can inspect the result.declinedPermissions to also
			provide more information to the user if they decline permissions.

			If `[FBSDKAccessToken currentAccessToken]` is not nil, it will be treated as a reauthorization for that user
			and will pass the "rerequest" flag to the login dialog.

			This method will present UI the user. You typically should check if `[FBSDKAccessToken currentAccessToken]`
			already contains the permissions you need before asking to reduce unnecessary app switching. For example,
			you could make that check at viewDidLoad.
			You can only do one login call at a time. Calling a login method before the completion handler is called
			on a previous login will return an error.
			*/
			- (void)logInWithPublishPermissions:(NSArray *)permissions
			fromViewController:(UIViewController *)fromViewController
			handler:(FBSDKLoginManagerRequestTokenHandler)handler;

			/*!
			@abstract Logs the user out
			@discussion This calls [FBSDKAccessToken setCurrentAccessToken:nil] and [FBSDKProfile setCurrentProfile:nil].
			/**
			Logs the user out

			This calls [FBSDKAccessToken setCurrentAccessToken:nil] and [FBSDKProfile setCurrentProfile:nil].
			*/
			- (void)logOut;

			/*!
			/**
			@method

			@abstract Issues an asychronous renewCredentialsForAccount call to the device's Facebook account store.
			Issues an asynchronous renewCredentialsForAccount call to the device's Facebook account store.

			@param handler The completion handler to call when the renewal is completed. This can be invoked on an arbitrary thread.
			- Parameter handler: The completion handler to call when the renewal is completed. This can be invoked on an arbitrary thread.

			@discussion This can be used to explicitly renew account credentials and is provided as a convenience wrapper around

			This can be used to explicitly renew account credentials and is provided as a convenience wrapper around
			`[ACAccountStore renewCredentialsForAccount:completion]`. Note the method will not issue the renewal call if the the
			Facebook account has not been set on the device, or if access had not been granted to the account (though the handler
			wil receive an error).