SocialService

Yöntemler

GetPlayersByPartyId(partyId : string):Instances
HideSelfView():()
Çağıran oyuncunun kendi görüşünü gizler.
PromptGameInvite(player : Instance,experienceInviteOptions : Instance):()
Verilen Player ile davet ekranıyla sorar.
PromptPhoneBook(player : Instance,tag : string):()
Verilen Player telefon rehberi ile sorar.
ShowSelfView(selfViewPosition : Enum.SelfViewPosition):()
Çağıran oyuncunun kendi görüşünü gösterir.
CanSendCallInviteAsync(player : Instance):boolean
Bekletir
Verdiğiniz Player 'nin diğer oyuncuları bir çağrıya davet edip edemeyeceğini gösterir.
CanSendGameInviteAsync(player : Instance,recipientId : number):boolean
Bekletir
Verdiğiniz Player 'nin diğer oyuncuları davet edebileceğini gösterir.
GetPartyAsync(partyId : string):Array
Bekletir

Etkinlikler

CallInviteStateChanged(player : Instance,inviteState : Enum.InviteState):RBXScriptSignal
Bir oyuncunun çağrısının durum değişikliği yaptığında ateş eder.
GameInvitePromptClosed(player : Instance,recipientIds : Array):RBXScriptSignal
Bir oyuncu davet istemesini kapattığında ateş eder.
PhoneBookPromptClosed(player : Instance):RBXScriptSignal
Bir oyuncu telefon rehberini kapattığında ateş eder.

Geri Aramalar

OnCallInviteInvoked(tag : string,callParticipantIds : Array):Instance
Telefon rehberinden bir çağrı yapıldığında geri çağrı.

Özellikler

Yöntemler

GetPlayersByPartyId

Instances

Parametreler

partyId: string

Varsayılan değer: ""

Dönüşler

Instances

HideSelfView

()

Çağıran oyuncunun kendi görüşünü gizler. Eğer bu yöntem kendi görüşü zaten gizlenmişken çağrılırsa, hiçbir şey yapmaz.

Dönüşler

()

PromptGameInvite

()

PromptGameInvite() yerel oyuncuya mevcut deneyime arkadaşlarını davet etmeleri için bir davet mesajı görüntüler.Bu yöntemi çağırmadan önce, oyuncunun bir davet gönderebileceğini belirlemek için CanSendGameInviteAsync() kullanmalısınız, çünkü bu yetenek platform veya oyuncu bağlı olarak değişebilir.

Davet isteklerinin uygulanması, özelleştirilmesi ve bildirimleri ve başlatma verilerinin kullanılması hakkında daha fazla ayrıntı için Oyuncu Davet İstekleri bakınız.

Parametreler

player: Instance

açılır pencerepenceresiyle istemek için Player .

Varsayılan değer: ""

experienceInviteOptions: Instance

Seçeneğe bağlı ExperienceInviteOptions nesne, istemciyi özelleştirmek için.

Varsayılan değer: "nil"

Dönüşler

()

Kod Örnekleri

The following code sample uses CanSendGameInviteAsync() to confirm whether the local Player can send an invite. If true, it then prompts the invite using PromptGameInvite().

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

()

Verilen Player telefon rehberi ile sorar.Oyuncu birisini aramayı seçerse, CallInviteStateChanged etkinliği ateşlenir.Telefon rehberini görme yeteneğinin oyuncuya bağlı olarak değişebileceğinden, CanSendCallInviteAsync() önce PromptPhoneBook() çağırmalısınız, çünkü telefon rehberini görme yeteneği oyuncuya bağlı olabilir.

Bir oyuncu telefon rehberini açmaya uygun değilse, bir hata diyaloğu gösterilir.

Bu yöntemin örnek bir uygulaması için Roblox Connect'e bakın.

Parametreler

player: Instance

Telefon rehberiyle soru sormak için oyuncu.

Varsayılan değer: ""

tag: string

Farklı telefon rehberi "giriş noktaları" veya benzerleri arasında ayırt etmek için yardımcı olan metin.Örneğin, çağrı yapan oyuncunun şu anda hangi deneyim bölgesinde olduğunu tanımlayan bir dize geçirebilirsiniz.

Varsayılan değer: ""

Dönüşler

()

Kod Örnekleri

The following code sample, placed within a child LocalScript of a GuiButton, uses CanSendCallInviteAsync() to confirm that the player can make a call. If so, it connects PromptPhoneBook() to the button's Activated event.

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

()

Çağıran oyuncunun kendi görüşünü gösterir. Eğer bu yöntem kendi görüşü zaten görülebilirken çağrılırsa, hiçbir şey yapmaz.

Parametreler

selfViewPosition: Enum.SelfViewPosition

Kendi görüntüsünü yerleştirmek için konum.

Varsayılan değer: "LastPosition"

Dönüşler

()

CanSendCallInviteAsync

Bekletir

Verilen 'a bir arama daveti gönderebilirse döndürür if the given can send a call invite to a arkadaş.Telefon rehberini açma yeteneği oyuncuya bağlı olarak değişebileceğinden, bu yöntemin sonucunu her zaman çağırmadan önce kullanmalısınız PromptPhoneBook() çünkü oyuncu bağımlı olabilir.

Bu yöntemin örnek bir uygulaması için Roblox Connect'e bakın.

Parametreler

player: Instance

Oyuncunun Player örneği potansiyel olarak bir çağrı daveti gönderiyor.

Varsayılan değer: ""

Dönüşler

Belirtilen oyuncu bir çağrı daveti gönderebilir mi.

Kod Örnekleri

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

Bekletir

CanSendGameInviteAsync() geri döndürür true eğer verilen Player mevcut deneyime diğer oyuncuları davet edebilirse.Oyuncuları davet etme yeteneği platform veya oyuncu bağlı olarak değişebileceğinden, bu yöntemin sonucunu her zaman çağırmadan önce kullanmalısınız PromptGameInvite() .

Oyuncu davet isteklerinin uygulanması, özelleştirilmesi ve bildirimlerin kullanılması ile ilgili daha fazla ayrıntı için Oyuncu Davet İstekleri bakınız. başlatma verilerini kullanma.

Parametreler

player: Instance

Oyuncunun Player potansiyel olarak bir davet göndermesi durumu.

Varsayılan değer: ""

recipientId: number

Opsiyonel Player.UserId potansiyel alıcının , gönderenin belirli alıcıyı davet edebileceğini kontrol etmek için kullanılan.

Varsayılan değer: 0

Dönüşler

Belirtilen oyuncunun bir davet gönderebileceği.

Kod Örnekleri

The following code sample uses CanSendGameInviteAsync() to confirm whether the local Player can send an invite. If true, it then prompts the invite using PromptGameInvite().

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

GetPartyAsync

Array

Bekletir

Parametreler

partyId: string

Varsayılan değer: ""

Dönüşler

Array

Etkinlikler

CallInviteStateChanged

Bu olay, bir oyuncunun çağrı daveti durumu değiştiğinde ateşlenir.

Parametreler

player: Instance

Çağrı daveti durumu değişikliği olan oyuncunun Player örneği.

inviteState: Enum.InviteState

Yeni çağrı davet durumu.

Kod Örnekleri

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

Bu etkinlik, bir oyuncu davet istemesini kapattığında ateşlenir.

Parametreler

player: Instance

Uyarıyı kapatan oyuncunun Player örneği.

recipientIds: Array

Artık doldurulmadı; boş bir dizi.

PhoneBookPromptClosed

Bir oyuncu telefon rehberini kapattığında ateş eder.

Parametreler

player: Instance

Telefon rehberini kapatan oyuncunun Player örneği.