SocialService
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
SocialService memudahkan fungsi sosial yang mempengaruhi hubungan yang dibuat di platform Roblox. Penggunaan utama adalah untuk menunjukkan undang undang prom示 dan buku telepon ke pemain, memungkinkan mereka untuk mengirim permintaan undangan ke teman mere
Rangkuman
Metode
Sembunyikan pandangan pemain yang menelepon diri mereka sendiri.
Mengundang Player yang diberikan dengan layar undangan.
Menginstruksikan Player yang diberikan dengan buku telepon.
Menunjukkan pandangan pemain yang memanggil diri.
Menunjukkan apakah Player yang diberikan dapat mengundang pemain lain untuk panggilan.
Menunjukkan apakah Player yang diberikan dapat mengundang pemain lain.
Acara
Diaktifkan ketika status undangan pemain berubah.
Dibakar saat seorang pemain menutup prompt undangan.
Dibakar saat seorang pemain menutup prompt buku telepon.
Callback
Panggilan kembali saat panggilan ditempatkan dari buku telepon.
Properti
Metode
HideSelfView
Sembunyikan pandangan pemain yang memanggil diri mereka sendiri. Jika metode ini dipanggil saat pandangan pemain sudah tersembunyi, itu tidak melakukan apa-apa.
Memberikan nilai
PromptGameInvite
PromptGameInvite() menampilkan undangan untuk pemain lokal melalui mana mereka dapat mengundang teman mereka ke pengalaman saat ini. Sebelum menggunakan metode ini, Anda harus menggunakan CanSendGameInviteAsync() untuk menentukan
Lihat Undang Pemain Prompt untuk lebih banyak rincian tentang menerapkan undang undang prompt, kustomisasi undang dan notifikasi, dan menggunakan data peluncuran.
Parameter
Class.Player untuk mengundang dengan pop-upundangan.
Objek ExperienceInviteOptions yang dapat diopsionalisasi untuk menyesuaikan prompt.
Memberikan nilai
Contoh Kode
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().
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
Menginstruksikan Player dengan buku telepon. Jika pemain memilih untuk menelepon seseorang, acara CallInviteStateChanged diaktifkan. Anda harus menggunakan Class
Jika seorang pemain tidak memenuhi syarat untuk membuka buku telepon, jendela dialog kesalahan ditunjukkan.
Lihat Roblox Connect untuk implementasi sampel metode ini.
Parameter
Pemain untuk mengundang dengan buku telepon.
String untuk membantu menentukan antara berbagai poin buku telepon "entri" atau serupa. Misalnya, Anda dapat mengirimkan string yang mendefinisikan wilayah pengalaman yang panggilan pemain berada saat ini.
Memberikan nilai
Contoh Kode
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.
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)
endShowSelfView
Menunjukkan pandangan pemain yang memanggil diri mereka sendiri. Jika metode ini dipanggil saat pandangan pemain sudah terlihat, itu tidak melakukan apa-apa.
Parameter
Posisi untuk menempatkan pandangan diri.
Memberikan nilai
CanSendCallInviteAsync
Mengembalikan true jika Player yang diberikan dapat mengirim undangan panggilan ke teman. Anda harus selalu menggunakan hasil metode ini sebelum memanggil PromptPhoneBook() karena kemampuan untuk membuka buku telepon dapat bervariasi tergantung pada pemain.
Lihat Roblox Connect untuk implementasi sampel metode ini.
Parameter
Class.Player instansi pemain potensial mengirim undangan panggilan.
Memberikan nilai
Apakah pemain yang ditentukan dapat mengirim undangan panggilan.
Contoh Kode
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.
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)
endCanSendGameInviteAsync
CanSendGameInviteAsync() mengembalikan true jika Player yang diberikan dapat mengundang pemain lain ke pengalaman saat ini. Anda harus selalu menggunakan hasil dari metode ini sebelum memanggil
Lihat Undang Pemain Prompt untuk lebih banyak rincian tentang menerapkan undangan pemain, menyesuaikan undangan, dan menggunakan data peluncuran.
Parameter
Class.Player instansi pemain potensial mengirim undangan.
Opsional Player.UserId dari potensi pelanggan , digunakan untuk memeriksa apakah pengirim dapat mengundang penerima khusus itu.
Memberikan nilai
Apakah pemain yang ditentukan dapat mengirim undangan.
Contoh Kode
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().
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
Acara
CallInviteStateChanged
Acara ini diaktifkan ketika status undangan pemain berubah.
Parameter
Class.Player instansi pemain yang memiliki status undangan panggilan.
Negara undangan panggilan baru.
Contoh Kode
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
Acara ini diaktifkan ketika seorang pemain menutup prompt undangan.
Parameter
Class.Player instansi pemain yang menutup prompt.
Tidak lagi populated; array kosong.
PhoneBookPromptClosed
Dibakar saat seorang pemain menutup prompt buku telepon.
Parameter
Class.Player instansi pemain yang menutup buku telepon.
Callback
OnCallInviteInvoked
Panggilan untuk memproses saat panggilan ditempatkan dari buku telepon. Paradigma tag dapat digunakan untuk menentukan antara berbagai " titik masuk " atau serupa, seperti yang dijelaskan dalam PromptPhoneBook() . Hanya satu panggilan dapat atur.
Parameter
String untuk membantu mengidentifikasi antara berbagai poin buku telepon.
Matrix mengandung semua pemain yang terlibat dalam panggilan. Pemanggil akan selalu menjadi pemain pertama dalam Matrix.
Memberikan nilai
Tabel termasuk PlaceId dan ReservedServerAccessCode kunci cupla yang cupla nilainya adalah DataModel.PlaceId dan kode akses server yang dikembalikan oleh 1> Class.TeleportService:ReserveServer()1> , masing-masing.
Contoh Kode
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