SocialService
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
SocialService , Roblox platformunda ilişkiyi etkileyen sosyal işlevleri kolaylaştırır. Temel kullanımı, oyunculara davet etme isteklerini göstermek ve telefon kitabını arkadaşlarına göndermelerine izin vermektir
Özet
Özellikler
Yöntemler
Çağırılan oyuncunun kendi görüntüsünü gizler.
Invite ekranıyla birlikte Player ile talimatları gösterir.
Class.Player ile telefon kitabıyla verilen talimatları gösterir.
oyuncukendi görüntüsünü gösterir.
Class.Player ile verilen çağrıyı diğer oyunculara davet edebileceğini gösterir.
Class.Player ın diğer oyuncuları davet etmeye izin verdiğini gösterir.
Etkinlikler
Bir oyuncunun çağırma daveti durumunu değiştirdiğinde ateşlenir.
Bir oyuncu bir davet etmeyi kapatırsa ateşlenir.
Bir oyuncu telefon kitabı isteğini kapattığında ateş eder.
Geri Aramalar
Özellikler
Yöntemler
HideSelfView
Çağırılan oyuncunun kendi görüntüsünü gizler. Bu yöntem, kendi görüntüsü zaten gizlenmişken çağırılırsa hiçbir şey yapmaz.
Dönüşler
PromptGameInvite
PromptGameInvite() , lokal oyuncuya bir davet etme istemini gösterir, arkadaşlarını mevcut deneyime davet etmeleri için. Bu yöntemi çağırmadan önce CanSendGameInviteAsync() kullanın, oyunc
Davet etmeyi etkinleştirmek için Oyuncu Daveti Etme Davet Etmeyi Getirme bakınız.
Parametreler
Class.ExperienceInviteOptions öğesi, davet mesajını özelleştirmek için gerekir.
Dönüşler
Kod Örnekleri
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
Gönderilen Player ile telefon kitabıyla etkileşime geçirir. Eğer oyuncu birini ararsa, CallInviteStateChanged etkinliği çağrılır. You should
Bir oyuncu telefon kitabını açmaya uygun değilse, bir hata diyalogu gösterilir.
Bu yöntemin bir özelleştirme örneği için Roblox Connect bakınız.
Parametreler
Telefon kitabıyla ilgili olan oyuncu.
Farklı bir telefon kitabı "giriş noktası" veya benzeri arasında fark yaratmak için kullanılan bir yol. Örneğin, bir bölgeyi tanımlayan bir yol oluşturabilirsiniz, böylece çağırıcı oyuncunun karakterinin şu anda hangi bölgede olduğunu gösterir.
Dönüşler
Kod Örnekleri
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
oyuncukendi görüntüsünü gösterir. Eğer bu yöntem, kendi görüntüsü zaten görünürken çağrılırsa, hiçbir şey yapmaz.
Parametreler
Kendi görüntüsünü yerleştirmenin yerleştirme pozisyonu.
Dönüşler
CanSendCallInviteAsync
Gönderilen true``Class.Player çağrı davetını bir arkadaşa gönderebilirse işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlemi işlem
Bu yöntemin bir özelleştirme örneği için Roblox Connect bakınız.
Parametreler
Dönüşler
Belirlenen oyuncunun bir çağrı daveti gönderebilip gönderemeyeceği.
Kod Örnekleri
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
CanSendGameInviteAsync()``true if the given Player can invite other players to the current experience. You should always use the result of this method before calling 0> Class.SocialService:PromptGameInvite()|PromptGameInvite()0> since the ability to invite
Oyuncu daveti alma, davetiye alma ve davet notlarını kullanma konusunda daha fazla bilgi için Oyuncu Daveti Etkileşim Kutusu bakın.
Parametreler
Gönderenin o özel alıcıyı davet edip etmediğini kontrol etmek için potansiyel Class.Player.UserId Class.Player.UserIdClass.Player.UserId 2>Class.Player.UserId2> 5>Class.Player.UserId5> 8>Class.Player.UserId8> 1>Class.Player.UserId1> 4>Class.Player.UserId4> Player.UserId7> 0>Class.Player.UserId0> Player.UserId3> 4>Class.Player
Dönüşler
Belirlenen oyuncunun bir davet gönderebilip gönderemeyeceği.
Kod Örnekleri
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
Etkinlikler
CallInviteStateChanged
Bu olay, bir oyuncunun çağrı daveti durumunu değiştirdiğinde başlar.
Parametreler
Yeni çağrı daveti devleti.
Kod Örnekleri
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 olay, bir oyuncu bir davet başvurusunu kapatınca başlar.
Parametreler
Class.Player oyuncusunun promptı kapattığındaki Class.Player instansı.
Artık popülasyonlanmıyor; boş bir matris.
Geri Aramalar
OnCallInviteInvoked
Parametreler
Dönüşler
Kod Örnekleri
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