SocialService

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Oluşturulamaz
Hizmet
Çoğaltılmamış

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

Yöntemler

Etkinlikler

Geri Aramalar

Özellikler

Yöntemler

HideSelfView

void

Ç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

void

PromptGameInvite

void

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

player: Instance

Davetiye açılır pencereile istediğiniz Player ile.

experienceInviteOptions: Instance

Class.ExperienceInviteOptions öğesi, davet mesajını özelleştirmek için gerekir.

Varsayılan değer: "nil"

Dönüşler

void

Kod Örnekleri

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

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

player: Instance

Telefon kitabıyla ilgili olan oyuncu.

tag: string

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

void

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

ShowSelfView

void

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

selfViewPosition: Enum.SelfViewPosition

Kendi görüntüsünü yerleştirmenin yerleştirme pozisyonu.

Varsayılan değer: "LastPosition"

Dönüşler

void

CanSendCallInviteAsync

Bekletir

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

player: Instance

Oyuncunun bir çağrı daveti göndermesi olası Player instansı.


Dönüşler

Belirlenen oyuncunun bir çağrı daveti gönderebilip gönderemeyeceği.

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()``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

player: Instance

Oyuncunun bir daveti göndermesi olası Player instansı.

recipientId: number

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

Varsayılan değer: 0

Dönüşler

Belirlenen oyuncunun bir davet gönderebilip gönderemeyeceği.

Kod Örnekleri

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

Etkinlikler

CallInviteStateChanged

Bu olay, bir oyuncunun çağrı daveti durumunu değiştirdiğinde başlar.

Parametreler

player: Instance

Oyuncunun bir çağrı daveti alma durumunu değiştiren Player instansı.

inviteState: Enum.InviteState

Yeni çağrı daveti devleti.


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 olay, bir oyuncu bir davet başvurusunu kapatınca başlar.

Parametreler

player: Instance

Class.Player oyuncusunun promptı kapattığındaki Class.Player instansı.

recipientIds: Array

Artık popülasyonlanmıyor; boş bir matris.


PhoneBookPromptClosed

Bir oyuncu telefon kitabı isteğini kapattığında ateş eder.

Parametreler

player: Instance

Telefon kitabını kapatan oyuncunun Player instansı.


Geri Aramalar

OnCallInviteInvoked

Parametreler

tag: string
callParticipantIds: Array

Dönüşler

Kod Örnekleri

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