JavaScript 版 Facebook SDK - 参考文档

更新时间: 2023年9月26日

为 LLM 复制

SDK 中可用方法和功能的完整列表的参考文档。

核心方法

方法	描述
`.init()`	用于初始化和设置此 SDK。所有其他 SDK 方法都必须在调用此方法后才能调用。
`.api()`	向 Graph API 发出 API 调用。
`.ui()`	用于触发 Facebook 创建的不同形式的用户界面对话框，如“动态”对话框或“请求”对话框。

方法	描述
`.getLoginStatus()`	返回用户的 Facebook 登录状态，若用户已登录，系统会附带 `authResponse` 对象。
`.login()`	提示用户使用弹出窗口中的登录对话框登录您的应用。此方法也可用于已登录的用户，以向他们请求额外的权限。
`.logout()`	用于使当前用户从您的网站或应用和以及 Facebook.com 登出。
`.getAuthResponse()`	当您的应用能够假定用户肯定是通过 Facebook 登录时，此同步方法可以返回 `authResponse` 对象，而无需异步调用带来的开销。

方法	描述
`.Event.subscribe()`	订阅在发生各种不同类型的操作（例如用户点击“赞”按钮或在评论框中添加内容）时触发的 JavaScript 事件。
`.Event.unsubscribe()`	移除之前创建的任何事件订阅。

此 Facebook SDK (JS) 应用事件 API 已停用，并且自 2022 年 7 月 1 日起不再受到支持。目前尚无为此产品添加新功能的计划。

我们建议通过 FB.AppEvents.LogEventMeta Pixel 像素代码传送这类事件，而不使用。

XFBML 是一種类似 HTML 的标记语言，具有可用于将社交插件插入 HTML 页面的特殊标签。

方法	描述
`.XFBML.parse()`	解析并呈现页面上的任何 XFBML。如果您在初始页面加载后将任何社交插件插入 DOM 中，或者在 `FB.init()` 中将 `xfbml` 设置为 `false`，此方法将非常有用。

这些方法仅适用于在 Canvas 页面中运行的 Facebook.com 应用。

方法	描述
`.Canvas.Prefetcher.addStaticResource()`	控制哪些静态资源会提前刷新到浏览器。
`.Canvas.Prefetcher.setCollectionMode()`	控制如何收集应用程序所用资源的统计数据，意图是影响是否提前将这些资源获取到浏览器或完全关闭预取。
`.Canvas.scrollTo()`	告知 Facebook 在您全屏广告页面的 iframe 中滚动至特定位置。
`.Canvas.setAutoGrow()`	启动或停止计时器，每隔几毫秒可调整 iframe 的大小。
`.Canvas.setSize()`	告知 Facebook 调整 iframe 的大小。
`.Canvas.setUrlHandler()`	注册用于内联处理（即无需重新加载页面）用户操作（例如点击 Live Ticker 游戏动态）的回调。
`.Canvas.setDoneLoading()`	报告页面现可供用户使用，以收集性能指标。
`.Canvas.startTimer()`	在使用 `.setDoneLoading()` 时，控制页面加载计时器。
`.Canvas.stopTimer()`	在使用 `.setDoneLoading()` 时，控制页面加载计时器。