SocialService

Métodos

HideSelfView():void
Oculta la vista de self del jugador que está llamando.
PromptGameInvite(player : Instance,experienceInviteOptions : Instance):void
Solicita el Player con la pantalla de invitación.
PromptPhoneBook(player : Instance,tag : string):void
Solicita el Player con el libro de teléfono.
ShowSelfView(selfViewPosition : Enum.SelfViewPosition):void
Muestra la vista de self del jugador que está llamando.
CanSendCallInviteAsync(player : Instance):bool
Rendimentos
Indica si el Player dado puede invitar a otros jugadores a una llamada.
CanSendGameInviteAsync(player : Instance,recipientId : number):bool
Rendimentos
Indica si el Player dado puede invitar a otros jugadores.

Eventos

CallInviteStateChanged(player : Instance,inviteState : Enum.InviteState):RBXScriptSignal
Dispara cuando el estado de invitación de un jugador cambia.
GameInvitePromptClosed(player : Instance,recipientIds : Array):RBXScriptSignal
Se activa cuando un jugador cierra una invitación.
PhoneBookPromptClosed(player : Instance):RBXScriptSignal
Se activa cuando un jugador cierra la solicitud de cierre del libro de teléfono.

Callbacks

OnCallInviteInvoked(tag : string,callParticipantIds : Array):Instance

Propriedades

Métodos

HideSelfView

void

Oculta la vista del jugador al que ha llamado. Si este método se llama mientras la vista del jugador ya está oculta, no hace nada.

Devolução

void

PromptGameInvite

void

PromptGameInvite() muestra una invitación para el jugador local a través de la cual puede invitar a sus amigos a la experiencia actual. Antes de llamar a este método, debe usar CanSendGameInviteAsync() para determinar si el jugador puede enviar una invitación, ya que esta capacidad puede variar dependiendo de

Vea Invitación de jugador invitaciones prompts para más detalles sobre la implementación de invitaciones, personalización de invitaciones y notificaciones, y el uso de datos de lanzamiento.

Parâmetros

player: Instance

El Player para solicitar con la ventana emergente de invitación.

experienceInviteOptions: Instance

Objeto ExperienceInviteOptions opcional para personalizar la invitación.

Valor Padrão: "nil"

Devolução

void

Amostras de código

Sending an Invite

local SocialService = game:GetService("SocialService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Function to check whether the player can send an invite
local function canSendGameInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendGameInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canInvite = canSendGameInvite(player)
if canInvite then
	SocialService:PromptGameInvite(player)
end

PromptPhoneBook

void

Solicita el Player con el libro de teléfonos. Si el jugador elige llamar a alguien, el evento CallInviteStateChanged se activa. Debes usar Class.SocialService:CanSendCallInviteAsync()|CanSendCallInv

Si un jugador no es elegible para abrir el libro de teléfono, se muestra un diálogo de error.

Vea Roblox Connect para una implementación de muestra de este método.

Parâmetros

player: Instance

El jugador para solicitar con el libro de teléfono.

tag: string

Una cadena para ayudar a diferenciar entre varios puntos de entrada de libro de teléfono o similares. Por ejemplo, puede pasar una cadena que define qué región de una experiencia está actualmente el personaje del jugador de llamada.

Devolução

void

Amostras de código

SocialService:PromptPhoneBook()

local Players = game:GetService("Players")
local SocialService = game:GetService("SocialService")

local player = Players.LocalPlayer
local button = script.Parent
button.Visible = false

-- Function to check whether the player can send a call invite
local function canSendCallingInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendCallInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canCall = canSendCallingInvite(player)
if canCall then
	button.Visible = true
	button.Activated:Connect(function()
		SocialService:PromptPhoneBook(player, "")
	end)
end

ShowSelfView

void

Muestra la vista de self del jugador que se llama. Si este método se llama mientras la vista de self ya es visible, no hace nada.

Parâmetros

selfViewPosition: Enum.SelfViewPosition

La posición para colocar la vista del selfie.

Valor Padrão: "LastPosition"

Devolução

void

CanSendCallInviteAsync

Rendimentos

Regresa true si el dado Player puede enviar una invitación de llamada a un amistad. Deberías usar siempre el resultado de este método antes de llamar PromptPhoneBook() ya que la capacidad de abrir el libro de teléfono puede variar dependiendo del jugador.

Vea Roblox Connect para una implementación de muestra de este método.

Parâmetros

player: Instance

La instancia Player del jugador que potencialmente envía una invitación de llamada.

Devolução

Si el jugador especificado puede enviar una invitación de llamada.

Amostras de código

SocialService:PromptPhoneBook()

local Players = game:GetService("Players")
local SocialService = game:GetService("SocialService")

local player = Players.LocalPlayer
local button = script.Parent
button.Visible = false

-- Function to check whether the player can send a call invite
local function canSendCallingInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendCallInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canCall = canSendCallingInvite(player)
if canCall then
	button.Visible = true
	button.Activated:Connect(function()
		SocialService:PromptPhoneBook(player, "")
	end)
end

CanSendGameInviteAsync

Rendimentos

CanSendGameInviteAsync() 返回 true 如果给定的 Player experiencia

Vea Invitación de jugador invitaciones de promoción para más detalles sobre la implementación de invitaciones de jugador, personalización de invitaciones y notificaciones y el uso de datos de lanzamiento.

Parâmetros

player: Instance

La instancia Player del jugador que potencialmente envía un invitación.

recipientId: number

Opcional Player.UserId del potencial receptor , se usa para ver si el remitente puede invitar a ese destinatarioespecífico.

Valor Padrão: 0

Devolução

Si el jugador especificado puede enviar un invitación.

Amostras de código

Sending an Invite

local SocialService = game:GetService("SocialService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Function to check whether the player can send an invite
local function canSendGameInvite(sendingPlayer)
	local success, canSend = pcall(function()
		return SocialService:CanSendGameInviteAsync(sendingPlayer)
	end)
	return success and canSend
end

local canInvite = canSendGameInvite(player)
if canInvite then
	SocialService:PromptGameInvite(player)
end

Eventos

CallInviteStateChanged

Este evento se activa cuando el estado de invitación de un jugador cambia.

Parâmetros

player: Instance

La instancia Player del jugador que tuvo un estado de invitación de llamada.

inviteState: Enum.InviteState

El nuevo estado de invitación de llamadas.

Amostras de código

SocialService.CallInviteStateChanged

local SocialService = game:GetService("SocialService")

local button = script.Parent
local isPhonebookOpen = false

SocialService.CallInviteStateChanged:Connect(function(_, inviteState)
	local isCalling = inviteState == Enum.InviteState.Placed

	if isCalling or isPhonebookOpen then
		button.Visible = false
	else
		button.Visible = true
	end
end)

GameInvitePromptClosed

Este evento se activa cuando un jugador cierra una invitación.

Parâmetros

player: Instance

La instancia de Player del jugador que cerró el mensaje.

recipientIds: Array

Ya no está populado; un arreglo vacío.

PhoneBookPromptClosed

Se activa cuando un jugador cierra la solicitud de cierre del libro de teléfono.

Parâmetros

player: Instance

La instancia Player del jugador que cerró el libro de teléfono.