facebook.showDialog()

概述

显示一个交互式 Facebook UI 对话框，可用于将帖子发布到用户的流、邀请好友使用您的应用等。如果您需要由应用程序本身进行发布，请使用 facebook.request()。

对话框的响应以 fbconnect 事件的形式返回，该事件会发送到 facebook.setFBConnectListener() 或 facebook.login() 中指定的监听器。

语法

facebook.showDialog( action, params )

分享对话框

显示用于共享内容的 Facebook 对话框。对于此对话框，action 应为 "link" 或 "photo"。

对于此对话框，params 表格可以包含以下key-value对。请注意，某些键是必需的，而另一些键则不是。

• link — 如果 action 为 "link"，则必需；对于要共享的内容的 URL，string 值。
• peopleIds — 可选 table，包含可与此内容一起标记的可标记人的 ID 列表。
• placeId — 可选 string 值，用于标记此内容的地点 ID。
• ref — 可选 string 值，当人员从他们 feed 中的此共享内容中点击链接时添加到引荐人 URL 中。
• title — 如果 action 为 "link"，则可选；用于显示此链接的标题的 string 值。
• description — 如果 action 为 "link"，则可选；包含链接说明的 string 值。
• picture — 如果 action 为 "link"，则为可选；字符串 值，用于指向要附加到此内容的图片的 URL。
• photos — 如果 action 为 "photo"，则为必需；数组，包含有关要共享的照片信息的 Lua 表。此数组中的每个表都应包含一个 url 键，其 字符串 值代表照片的 URL。

游戏请求对话框

显示一个原生视图，允许用户向他们选择的密友发送游戏请求。对于此对话框，action 应该为 "requests"。

对于此对话框，params 表格可以包含以下key-value对

• to — 字符串 值，用于发送此请求的人员的用户 ID。
• title — 字符串 值，用于对话框的标题。
• message — 字符串 值，用于随游戏请求一起发送的消息。
• suggestions — 表，包含此游戏请求建议朋友的用户 ID。
• data — 字符串 值，用于附加到帖子上的附加数据。
• objectId — 字符串 值，用于正在发送的对象的开放图谱对象 ID。
• actionType — 字符串 值，用于定义关于请求性质的附加上下文。默认情况下，不使用操作类型。受支持的 actionType 值包括
  • "SEND" — 用户向密友发送一个对象。还需要提供 objectId。映射到 赠送礼物和社交交易 场景。
  • "ASKFOR" — 用户向密友索要一个对象。还需要提供 objectId。映射到 请求帮助 场景。
  • "TURN" — 轮到密友在比赛中与用户对战。在这种情况下，不应提供 objectId。映射到 回合制游戏 场景。
• filter — 字符串 值，用于筛选可以显示在多用户选择器中的人员。默认情况下，所有密友都将显示在选择器中。受支持的 filter 值包括
  • "APP_USERS" — 仅使用该应用的密友将被显示。
  • "APP_NON_USERS" — 不使用该应用的密友将被显示。映射到 邀请函 场景。

示例

local facebook = require( "plugin.facebook.v4" )

local function facebookListener( event )

    if ( "session" == event.type ) then
        if ( "login" == event.phase ) then

            local shareParams = {
                link = "https://www.coronalabs.com/",
                title = "Corona Labs"
            }
            facebook.showDialog( "link", shareParams )
        end

    elseif ( "dialog" == event.type ) then
        print( event.response )
    end
end

facebook.login( facebookListener )

local facebook = require( "plugin.facebook.v4" )

local function facebookListener( event )

    if ( "session" == event.type ) then
        if ( "login" == event.phase ) then
        
            facebook.showDialog( "requests", 
                { 
                    message = "You should download this game!",
                    filter = "APP_NON_USERS"
                })
        end

    elseif ( "dialog" == event.type ) then
        print( event.response )
    end
end

facebook.login( facebookListener )