FacebookDialog.PhotoShareDialogBuilder - 文档

FacebookDialog.PhotoShareDialogBuilder

最新版的 SDK 已不支持此类。
这个类有新版本。查看最新版本。

Provides a builder which can construct a FacebookDialog instance suitable for presenting the native Share dialog for sharing photos. This builder will throw an exception if the Facebook application is not installed, so it should only be used if FacebookDialog.canPresentShareDialog(android.content.Context, com.facebook.widget.FacebookDialog.ShareDialogFeature...) indicates the capability is available.

扩展：	`Object`
应用安装包：	`widget`

构造函数

FacebookDialog.PhotoDialogBuilderBase(Activity)

Constructor.

public FacebookDialog.PhotoDialogBuilderBase(Activity activity)

参数	描述
`activity`	The Activity which is presenting the native Share dialog; must not be null

FacebookDialog.PhotoShareDialogBuilder(Activity)

Constructor.

public FacebookDialog.PhotoShareDialogBuilder(Activity activity)

参数	描述
`activity`	The Activity which is presenting the native Share dialog; must not be null

实例方法

setRequestCode(int)

Sets the request code that will be passed to handleActivityResult when this activity completes; the default is NativeProtocol.DIALOG_REQUEST_CODE.

public Builder setRequestCode(int requestCode)

参数	描述
`requestCode`	The request code

Returns

This instance of the builder

setApplicationName(String)

Sets the name of the application to be displayed in the dialog. If provided, this optimizes the user experience as a preview of a shared item, etc., can be displayed sooner.

public Builder setApplicationName(String applicationName)

参数	描述
`applicationName`	The name of the Facebook application

Returns

This instance of the builder

setFragment(Fragment)

Sets the fragment that should launch the dialog. This allows the dialog to be launched from a Fragment, and will allow the fragment to receive the onActivityResult.onActivityResult(int, int, android.content.Intent) call rather than the Activity.

public Builder setFragment(Fragment fragment)

参数	描述
`fragment`	The fragment that contains this control

build()

Constructs a FacebookDialog with an Intent that is correctly populated to present the dialog within the Facebook application.

public FacebookDialog build()

Returns

A FacebookDialog instance

canPresent()

Determines whether the native dialog can be presented (i.e., whether the required version of the Facebook application is installed on the device, and whether the installed version supports all of the parameters specified for the dialog).

public boolean canPresent()

Returns

True if the dialog can be presented; false if not

addImageAttachments(Collection)

protected List addImageAttachments(Collection bitmaps)

参数	描述
`bitmaps`

addImageAttachmentFiles(Collection)

protected List addImageAttachmentFiles(Collection bitmapFiles)

参数	描述
`bitmapFiles`

addImageAttachment(String, Bitmap)

protected Builder addImageAttachment(String imageName, Bitmap bitmap)

参数	描述
`imageName`
`bitmap`

addImageAttachment(String, File)

protected Builder addImageAttachment(String imageName, File attachment)

参数	描述
`imageName`
`attachment`

setPlace(String)

Sets the place for the item to be shared.

public PhotoDialogBuilderBase setPlace(String place)

参数	描述
`place`	The Facebook ID of the place

Returns

This instance of the builder

setFriends(List)

Sets the tagged friends for the item to be shared.

public PhotoDialogBuilderBase setFriends(List friends)

参数	描述
`friends`	A list of Facebook IDs of the friends to be tagged in the shared item

Returns

This instance of the builder

addPhotos(Collection)

Adds one or more photos to the list of photos to display in the native Share dialog, by providing an in-memory representation of the photos. The dialog's callback will be called once the user has shared the photos, but the photos themselves may be uploaded in the background by the Facebook app; apps wishing to be notified when the photo upload has succeeded or failed should extend the FacebookBroadcastReceiver class and register it in their AndroidManifest.xml. In order for the images to be provided to the Facebook application as part of the app call, the NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.

public PhotoDialogBuilderBase addPhotos(Collection photos)

参数	描述
`photos`	A collection of Files representing photos to be uploaded

Returns

This instance of the builder

addPhotoFiles(Collection)

Adds one or more photos to the list of photos to display in the native Share dialog, by specifying their location in the file system. The dialog's callback will be called once the user has shared the photos, but the photos themselves may be uploaded in the background by the Facebook app; apps wishing to be notified when the photo upload has succeeded or failed should extend the FacebookBroadcastReceiver class and register it in their AndroidManifest.xml.

public PhotoDialogBuilderBase addPhotoFiles(Collection photos)

参数	描述
`photos`	A collection of Files representing photos to be uploaded

Returns

This instance of the builder

常量

activity

protected final Activity activity

applicationId

protected final String applicationId

appCall

protected final PendingCall appCall