SocialService

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile

Assistenza

Non Replicato

SocialService facilita le funzionalità social che hanno impatto sulle relazioni fatte sulla PiattaformaRoblox. La sua utilità principale è mostrare richieste di invito e il libro telefonico ai giocatori, consentendo loro di inviare richieste di invito ai loro amici attraverso Class.SocialService:PromptGameInvite()|

Sommario

Proprietà

Visualizza tutti gli elementi ereditati da Instance

Visualizza tutti gli elementi ereditati da Object

Metodi

HideSelfView():void
Nasconde la vista dell'auto Giocatore.
PromptGameInvite(player : Instance,experienceInviteOptions : Instance):void
Richiede il Player con lo schermo di invito.
PromptPhoneBook(player : Instance,tag : string):void
Richiede il Player con il libro di telefono.
ShowSelfView(selfViewPosition : Enum.SelfViewPosition):void
Mostra la vista dell'auto di chiamata.
CanSendCallInviteAsync(player : Instance):bool
Resa
Indica se il Player dato può invitare altri giocatori a una chiamata.
CanSendGameInviteAsync(player : Instance,recipientId : number):bool
Resa
Indica se il Player dato può invitare altri giocatori.

Visualizza tutti gli elementi ereditati da Instance

Visualizza tutti gli elementi ereditati da Object

Eventi

CallInviteStateChanged(player : Instance,inviteState : Enum.InviteState):RBXScriptSignal
Si attiva quando lo stato di invito alla chiamata di un Giocatorecambia.
GameInvitePromptClosed(player : Instance,recipientIds : Array):RBXScriptSignal
Si attiva quando un giocatore chiude un invito.
PhoneBookPromptClosed(player : Instance):RBXScriptSignal
Si attiva quando un giocatore chiude la richiesta del telefono.

Visualizza tutti gli elementi ereditati da Instance

Visualizza tutti gli elementi ereditati da Object

Richiami

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

Proprietà

Visualizza tutti gli elementi ereditati da Instance

Visualizza tutti gli elementi ereditati da Object

Metodi

HideSelfView

void

Nasconde la vista del Giocatorechiamato. Se questo metodo viene chiamato mentre la vista del giocatore è già nascosta, non fa nulla.

Restituzioni

void

PromptGameInvite

void

PromptGameInvite() mostra un invito alla richiesta del giocatore locale attraverso cui potrebbero invitare i loro amici nell'esperienza corrente. Prima di chiamare questo metodo, dovresti usare CanSendGameInviteAsync() per determinare se il giocatore può invitare, poiché questa capac

Vedi Invito del giocatore Prompts per ulteriori dettagli sull'implementazione di inviti, personalizzazione di inviti e notifiche e l'utilizzo di dati di avvio.

Parametri

player: Instance

Il Player per invitare con la Pop-up, Notificadi invito.

experienceInviteOptions: Instance

Opzionale ExperienceInviteOptions oggetto per la personalizzazione della richiesta.

Valore predefinito: "nil"

Restituzioni

void

Campioni di codice

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

Richiede il Player con il libro di telefono. Se il Giocatoresceglie di chiamare qualcuno, l'evento CallInviteStateChanged viene attivato. Dovresti usare Class.SocialService:Can

Se un giocatore non è idoneo per aprire il libro di telefono, viene mostrato un dialogo di errore.

Vedi Roblox Connect per un'esecuzione di esempio di questo metodo.

Parametri

player: Instance

Il giocatore a cui chiedere con il libro di telefono.

tag: string

Stringa per aiutare a distinguere tra diversi punti di ingresso del libro telefonico " punto di ingresso ". Ad esempio, puoi passare una stringa che definisce la regione di un'esperienza in cui si trova attualmente il personaggio dell'Giocatore.

Restituzioni

void

Campioni di codice

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

Mostra la vista del Giocatorechiamato. Se questo metodo viene chiamato mentre la vista del giocatore è già visibile, non fa nulla.

Parametri

selfViewPosition: Enum.SelfViewPosition

La posizione in cui posizionare la visuale di sé .

Valore predefinito: "LastPosition"

Restituzioni

void

CanSendCallInviteAsync

bool

Resa

Ritorna true se il Player dato può inviare un invito di chiamata a un Amico/Amica. Dovresti sempre utilizzare il risultato di questo metodo prima di chiamare PromptPhoneBook() poiché la capacità di aprire il libro telefonico può variare a seconda del Giocatore.

Vedi Roblox Connect per un'esecuzione di esempio di questo metodo.

Parametri

player: Instance

L'istanza Player del giocatore che potenzialmente invia un invito alla chiamata.

Restituzioni

bool

Se il giocatore specificato può inviare un invito alla chiamata.

Campioni di codice

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

bool

Resa

CanSendGameInviteAsync() restituisce true se il Player dato può invitare altri giocatori all'esperienza corrente. Dovresti sempre utilizzare il risultato di questo metodo prima di chiamare 0> Class.SocialService:PromptGameInvite

Vedi Invito del giocatore Prompts per ulteriori dettagli sull'implementazione di inviti del giocatore, personalizzazione delle richieste e notifiche e l'utilizzo di dati di avvio.

Parametri

player: Instance

L'istanza Player del giocatore che potenzialmente invia un invito.

recipientId: number

Opzionale Player.UserId del potenziale destinatario , usato per controllare se il mittente può invitare quel Destinatariospecifico.

Valore predefinito: 0

Restituzioni

bool

Se il giocatore specificato può inviare un invito.

Campioni di codice

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

Visualizza tutti gli elementi ereditati da Instance

Visualizza tutti gli elementi ereditati da Object

Eventi

CallInviteStateChanged

Questo evento si attiva quando lo stato di invito di un Giocatorecambia.

Parametri

player: Instance

L'istanza Player del giocatore che aveva uno stato di invito di chiamata.

inviteState: Enum.InviteState

Lo stato di invito alla nuova chiamata.

Campioni di codice

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

Questo evento si attiva quando un giocatore chiude un invito.

Parametri

player: Instance

L'istanza Player del giocatore che ha chiuso la richiesta.

recipientIds: Array

Non più popolato; un vettorevuoto.

PhoneBookPromptClosed

Si attiva quando un giocatore chiude la richiesta del telefono.

Parametri

player: Instance

L'istanza Player del giocatore che ha chiuso il libro telefonico.

Visualizza tutti gli elementi ereditati da Instance

Visualizza tutti gli elementi ereditati da Object

Richiami

OnCallInviteInvoked

Instance

Parametri

tag: string

callParticipantIds: Array

Restituzioni

Instance

Campioni di codice

SocialService.OnCallInviteInvoked

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

SocialService.OnCallInviteInvoked = function()
	local placeId = 0123456789  -- This is the place ID of the desired place to drop call participants into
	local accessCode = TeleportService:ReserveServer(placeId)

	return { ReservedServerAccessCode = accessCode, PlaceId = placeId }
end