SocialService

วิธีการ

GetPlayersByPartyId(partyId : string):Instances
HideSelfView():()
ซ่อนมุมมองตนเองของผู้เล่นที่เรียก
PromptGameInvite(player : Instance,experienceInviteOptions : Instance):()
แจ้งให้ผู้ใช้ให้ Player กับหน้าจอเชิญ
PromptPhoneBook(player : Instance,tag : string):()
ส่งคำถามให้กับ Player ที่กำหนดด้วยสมุดโทรศัพท์
ShowSelfView(selfViewPosition : Enum.SelfViewPosition):()
แสดงมุมมองตนเองของผู้เล่นที่เรียก
CanSendCallInviteAsync(player : Instance):boolean
ผลตอบแทน
บ่งบอกว่าให้ Player ที่กำหนดสามารถเชิญผู้เล่นคนอื่นเข้าสู่การโทรได้หรือไม่
CanSendGameInviteAsync(player : Instance,recipientId : number):boolean
ผลตอบแทน
บ่งบอกว่าให้ Player ที่กำหนดสามารถเชิญผู้เล่นคนอื่นได้หรือไม่
GetPartyAsync(partyId : string):Array
ผลตอบแทน

อีเวนต์

CallInviteStateChanged(player : Instance,inviteState : Enum.InviteState):RBXScriptSignal
เกิดไฟไหม้เมื่อสถานะการเรียกของผู้เล่นเปลี่ยนแปลง
GameInvitePromptClosed(player : Instance,recipientIds : Array):RBXScriptSignal
เกิดไฟไหม้เมื่อผู้เล่นปิดการแจ้งเตือนการเชิญ
PhoneBookPromptClosed(player : Instance):RBXScriptSignal
เกิดไฟไหม้เมื่อผู้เล่นปิดการแจ้งเตือนในสมุดโทรศัพท์

Callbacks

OnCallInviteInvoked(tag : string,callParticipantIds : Array):Instance
การโทรกลับเมื่อมีการวางสายจากสมุดโทรศัพท์

คุณสมบัติ

วิธีการ

GetPlayersByPartyId

Instances

พารามิเตอร์

partyId: string

ค่าเริ่มต้น: ""

ส่งค่ากลับ

Instances

HideSelfView

()

ซ่อนมุมมองตัวเองของผู้เล่นที่เรียก หากวิธีนี้ถูกเรียกในขณะที่มุมมองตัวเองถูกซ่อนไว้แล้ว มันจะไม่ทำอะไรเลย

ส่งค่ากลับ

()

PromptGameInvite

()

PromptGameInvite() แสดงคำเชิญชวนให้กับผู้เล่นท้องถิ่นผ่านทางซึ่งพวกเขาสามารถเชิญเพื่อนของพวกเขาไปยังประสบการณ์ปัจจุบันได้ก่อนที่จะเรียกวิธีนี้คุณควรใช้ CanSendGameInviteAsync() เพื่อตรวจสอบว่าผู้เล่นสามารถส่งคำเชิญได้หรือไม่เนื่องจากความสามารถนี้อาจแตกต่างกันไปขึ้นอยู่กับแพลตฟอร์มหรือผู้เล่น

ดู คำเชิญชวนผู้เล่น สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการดำเนินการคำเชิญชวน, การปรับแต่งคำเชิญชวนและการแจ้งเตือน และการใช้ข้อมูลเปิดตัว

พารามิเตอร์

player: Instance

The Player ป็อปอัพ

ค่าเริ่มต้น: ""

experienceInviteOptions: Instance

วัตถุทางเลือก ExperienceInviteOptions สำหรับการปรับแต่งแจ้งเตือน

ค่าเริ่มต้น: "nil"

ส่งค่ากลับ

()

ตัวอย่างโค้ด

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

()

ส่งคำถามให้กับ Player ที่กำหนดด้วยสมุดโทรศัพท์หากผู้เล่นเลือกที่จะโทรหาใครสักคน กิจกรรม CallInviteStateChanged จะเกิดขึ้นคุณควรใช้ CanSendCallInviteAsync() ก่อนที่จะโทร PromptPhoneBook() เนื่องจากความสามารถในการดูรายชื่อโทรศัพท์อาจแตกต่างกันไปขึ้นอยู่กับผู้เล่น

หากผู้เล่นไม่สามารถเปิดสมุดโทรศัพท์ได้ จะมีการแสดงข้อความแจ้งข้อผิดพลาด

ดู Roblox Connect สำหรับการใช้งานตัวอย่างของวิธีนี้

พารามิเตอร์

player: Instance

ผู้เล่นที่จะแจ้งกับหนังสือโทรศัพท์

ค่าเริ่มต้น: ""

tag: string

สตริงเพื่อช่วยแยกแยะระหว่างจุดเข้า "หนังสือโทรศัพท์" หรือคล้ายกันตัวอย่างเช่น ผู้เล่น

ค่าเริ่มต้น: ""

ส่งค่ากลับ

()

ตัวอย่างโค้ด

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

()

แสดงมุมมองตัวเองของผู้เล่นที่เรียก หากวิธีนี้ถูกเรียกในขณะที่มุมมองตัวเองมีอยู่แล้ว มันจะไม่ทำอะไรเลย

พารามิเตอร์

selfViewPosition: Enum.SelfViewPosition

ตำแหน่งที่จะวางมุมมองตนเอง

ค่าเริ่มต้น: "LastPosition"

ส่งค่ากลับ

()

CanSendCallInviteAsync

ผลตอบแทน

ส่งคืน true หากการให้ Player สามารถส่งคำเชิญโทรไปยังเพื่อนได้คุณควรใช้ผลของวิธีนี้เสมอก่อนที่จะโทร PromptPhoneBook() เนื่องจากความสามารถในการเปิดสมุดโทรศัพท์อาจแตกต่างกันไปขึ้นอยู่กับผู้เล่น

ดู Roblox Connect สำหรับการใช้งานตัวอย่างของวิธีนี้

พารามิเตอร์

player: Instance

ตัวอย่าง Player ของผู้เล่นอาจส่งคำเชิญโทรได้

ค่าเริ่มต้น: ""

ส่งค่ากลับ

ว่าผู้เล่นที่ระบุสามารถส่งคำเชิญโทรได้หรือไม่

ตัวอย่างโค้ด

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

ผลตอบแทน

CanSendGameInviteAsync() ส่งคืน true หากการให้ Player สามารถเชิญผู้เล่นคนอื่นเข้าสู่ประสบการณ์ปัจจุบันได้คุณควรใช้ผลของวิธีนี้เสมอก่อนที่จะเรียก PromptGameInvite() เนื่องจากความสามารถในการเชิญผู้เล่นอาจแตกต่างกันไปขึ้นอยู่กับแพลตฟอร์มหรือผู้เล่น

ดู คําเชิญผู้เล่น สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับการดําเนินการคําเชิญผู้เล่นการปรับแต่งคําเชิญและการแจ้งเตือน และการใช้ข้อมูลเปิดตัว

พารามิเตอร์

player: Instance

ตัวอย่าง Player ของผู้เล่นที่อาจส่งคำเชิญ

ค่าเริ่มต้น: ""

recipientId: number

ตัวเลือก Player.UserId ของผู้รับที่อาจจะเป็นไปได้ **** ใช้เพื่อตรวจสอบว่าผู้ส่งสามารถเชิญผู้รับเฉพาะรายนั้นได้หรือไม่

ค่าเริ่มต้น: 0

ส่งค่ากลับ

ว่าผู้เล่นที่ระบุสามารถส่งคำเชิญได้หรือไม่

ตัวอย่างโค้ด

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

ผลตอบแทน

พารามิเตอร์

partyId: string

ค่าเริ่มต้น: ""

ส่งค่ากลับ

Array

อีเวนต์

CallInviteStateChanged

อีเวนต์นี้จะเกิดขึ้นเมื่อสถานะการเชิญสายของผู้เล่นเปลี่ยนแปลง

พารามิเตอร์

player: Instance

ตัวอย่าง Player ของผู้เล่นที่มีสถานะเปลี่ยนการเรียกเรียกเปลี่ยน

inviteState: Enum.InviteState

สถานะการเชิญโทรใหม่

ตัวอย่างโค้ด

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

อีเวนต์นี้จะเกิดขึ้นเมื่อผู้เล่นปิดการแจ้งเตือนการเชิญ

พารามิเตอร์

player: Instance

ตัวอย่าง Player ของผู้เล่นที่ปิดการแจ้งเตือน

recipientIds: Array

ไม่ได้เติมแล้ว; เป็น阵列ว่างเปล่า

PhoneBookPromptClosed

เกิดไฟไหม้เมื่อผู้เล่นปิดการแจ้งเตือนในสมุดโทรศัพท์

พารามิเตอร์

player: Instance

ตัวอย่าง Player ของผู้เล่นที่ปิดหนังสือโทรศัพท์