SocialService

Metody

HideSelfView():void
Ukrywa samą widok gracza.
PromptGameInvite(player : Instance,experienceInviteOptions : Instance):void
Prosi Player z ekranem zaproszenia.
PromptPhoneBook(player : Instance,tag : string):void
Podaje Player z telefonem.
ShowSelfView(selfViewPosition : Enum.SelfViewPosition):void
Pokazuje samo widok gracza.
CanSendCallInviteAsync(player : Instance):bool
Wynik
Wskazuje, czy dany Player może zaprosić innych graczy do wezwania.
CanSendGameInviteAsync(player : Instance,recipientId : number):bool
Wynik
Wskazuje, czy dany Player może zapraszać innych graczy.

Zdarzenia

CallInviteStateChanged(player : Instance,inviteState : Enum.InviteState):RBXScriptSignal
Wykonuje się, gdy stan zaproszenia gracza się zmienia.
GameInvitePromptClosed(player : Instance,recipientIds : Array):RBXScriptSignal
Wystrzela, gdy gracz zamyka zaproszenie.
PhoneBookPromptClosed(player : Instance):RBXScriptSignal
Wystarczy, gdy gracz zamknie telefon.

Wywołania zwrotne

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

Właściwości

Metody

HideSelfView

void

Ukrywa samo widzenie gracza. Jeśli ten metod jest wywołany, gdy samo widzenie jest już ukryte, to nie robi nic.

Zwroty

void

PromptGameInvite

void

PromptGameInvite() wyświetla prośbę o zaproszenie lokalnego gracza, poprzez którego może zaprosić swoich przyjaciół do obecnej doświadczenia. Przed wezwaniem tej metody należy użyć CanSendGameInviteAsync() , aby okreś

Zobacz Zaproś zaproszenie gracza dla więcej szczegółów wdrożenia zaproszeń, dostosowywania zaproszeń i powiadomień i używania danych uruchomienia.

Parametry

player: Instance

Class.Player do wysłania okno wyskakujące, monit.

experienceInviteOptions: Instance

Opcjonalny ExperienceInviteOptions obiekt do dostosowania zaproszenia.

Wartość domyślna: "nil"

Zwroty

void

Przykłady kodu

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

Wyświetla Player z telefonem. Jeśli gracz wybiera kogoś, aby zadzwonić, wydarza się CallInviteStateChanged wydarzenie. Powinieneś używać Class.

Jeśli gracz nie jest uprawniony do otwarcia książki telefonu, jest wyświetlony dialog błędu.

Zobacz Roblox Connect dla przykładowej implementacji tego metody.

Parametry

player: Instance

Gracz, który prosi z telefonu.

tag: string

String pomaga zidentyfikować różne punkty wejścia do książki telefonów lub podobnych. Na przykład możesz przesłać string zdefiniowując, w którym regionie jest obecnie postać gracza.

Zwroty

void

Przykłady kodu

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

Pokazuje samo widzenie gracza. Jeśli ten metod jest wywołany, gdy samo widzenie jest już widoczne, to nie robi nic.

Parametry

selfViewPosition: Enum.SelfViewPosition

Pozycja do umieszczenia samo widok .

Wartość domyślna: "LastPosition"

Zwroty

void

CanSendCallInviteAsync

Wynik

Wykonuje true jeśli dany Player może wysłać zaproszenie do znajomy. Zawsze używaj wyniku tego metody przed wzywaniem PromptPhoneBook(), ponieważ możliwość otwarcia książki telefonu może się różnić w zależności od gracza.

Zobacz Roblox Connect dla przykładowej implementacji tego metody.

Parametry

player: Instance

Przypadkowe Player instancja gracza wysyłająca zaproszenie do wezwania.

Zwroty

Czy określony gracz może wysłać zaproszenie do wezwania.

Przykłady kodu

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

Wynik

CanSendGameInviteAsync() zwraca true jeśli dany Player może zaprosić innych graczy do obecnej doświadczenia. Zawsze używaj wyniku tego metody przed wezwaniem 0> Class.SocialService:PromptGameInv

Zobacz Zaproś gracza zaproszeń po więcej szczegółów wdrożenia zaproszeń graczy, dostosowania zaproszeń i powiadomień, a także użycia danych uruchomienia.

Parametry

player: Instance

Instancja Player gracza potencjalnie wysyłającego zaproszenie.

recipientId: number

Opcjonalny Player.UserId z potencjalnego odbiorcy , używany do sprawdzenia, czy nadawca może zaprosić tego konkretnego odbiorca.

Wartość domyślna: 0

Zwroty

Czy określony gracz może wysłać zaproszenie.

Przykłady kodu

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

Zdarzenia

CallInviteStateChanged

Ten ewent wyzwany, gdy stanie się stale zaproszeniem do wezwania.

Parametry

player: Instance

Instancja Player gracza, który miał status zaproszenia do wezwania.

inviteState: Enum.InviteState

Nowy stan zaproszenia wezwania.

Przykłady kodu

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

Ten ewent wyzwany zostanie, gdy gracz zamknie zaproszenie.

Parametry

player: Instance

Instancja Player gracza, który zamknął prośbę.

recipientIds: Array

Nie jest już zaludnione; pusty wskaźnik.

PhoneBookPromptClosed

Wystarczy, gdy gracz zamknie telefon.

Parametry

player: Instance

Przypisanie Player instancji gracza, który zamknął książkę telefonów.