SocialService

Phương Pháp

GetPlayersByPartyId(partyId : string):Instances
HideSelfView():()
Ẩn góc nhìn tự thân của người gọi.
PromptGameInvite(player : Instance,experienceInviteOptions : Instance):()
Yêu cầu đưa ra Player với màn hình mời.
PromptPhoneBook(player : Instance,tag : string):()
Yêu cầu đưa ra Player với cuốn sách điện thoại.
ShowSelfView(selfViewPosition : Enum.SelfViewPosition):()
Hiển thị quan điểm tự nhìn của người gọi.
CanSendCallInviteAsync(player : Instance):boolean
Sinh Lợi
Chỉ ra xem liệu đã cho Player có thể mời các người chơi khác vào cuộc gọi hay không.
CanSendGameInviteAsync(player : Instance,recipientId : number):boolean
Sinh Lợi
Chỉ ra xem liệu đã cho Player có thể mời những người chơi khác không.
GetPartyAsync(partyId : string):Array
Sinh Lợi

Sự Kiện

CallInviteStateChanged(player : Instance,inviteState : Enum.InviteState):RBXScriptSignal
Bắt lửa khi tình trạng cuộc gọi của người chơi thay đổi.
GameInvitePromptClosed(player : Instance,recipientIds : Array):RBXScriptSignal
Bắt lửa khi một người chơi đóng lại một lời mời.
PhoneBookPromptClosed(player : Instance):RBXScriptSignal
Bắt lửa khi một người chơi đóng lại lời nhắc danh bộ điện thoại.

Gọi Lại

OnCallInviteInvoked(tag : string,callParticipantIds : Array):Instance
Gọi lại khi cuộc gọi được thực hiện từ cuốn sách điện thoại.

Thuộc Tính

Phương Pháp

GetPlayersByPartyId

Instances

Tham Số

partyId: string

Giá Trị Mặc Định: ""

Lợi Nhuận

Instances

HideSelfView

()

Ẩn góc nhìn tự thân của người gọi. Nếu phương pháp này được gọi khi góc nhìn tự thân đã được ẩn, nó không làm gì cả.

Lợi Nhuận

()

PromptGameInvite

()

PromptGameInvite() hiển thị một lời mời nhanh cho người chơi địa phương thông qua đó họ có thể mời bạn bè của họ vào trải nghiệm hiện tại.Trước khi gọi phương thức này, bạn nên sử dụng CanSendGameInviteAsync() để xác định xem người chơi có thể gửi lời mời hay không, vì khả năng này có thể thay đổi tùy thuộc vào nền tảng hoặc người chơi.

Xem Lời mời người chơi để có thêm chi tiết về việc triển khai lời mời, tùy chỉnh lời mời và thông báo, và sử dụng dữ liệu khởi động.

Tham Số

player: Instance

The Player để yêu cầu với popup mời.

Giá Trị Mặc Định: ""

experienceInviteOptions: Instance

Vật phẩm tùy chọn ExperienceInviteOptions để tùy chỉnh lời nhắc.

Giá Trị Mặc Định: "nil"

Lợi Nhuận

()

Mẫu mã

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

()

Yêu cầu đưa ra Player với cuốn sách điện thoại.Nếu người chơi chọn gọi ai đó, sự kiện CallInviteStateChanged bắt lửa.Bạn nên sử dụng CanSendCallInviteAsync() trước khi gọi PromptPhoneBook() vì khả năng xem danh bạ điện thoại có thể thay đổi tùy thuộc vào người chơi.

Nếu một người chơi không đủ điều kiện để mở cuốn sách điện thoại, một hộp thoại lỗi được hiển thị.

Xem Kết nối Roblox để có một ví dụ thực hiện phương pháp này.

Tham Số

player: Instance

Người chơi để yêu cầu với cuốn sách điện thoại.

Giá Trị Mặc Định: ""

tag: string

Chuỗi để giúp phân biệt giữa các "điểm nhập" sách điện thoại khác nhau hoặc tương tự.Ví dụ, bạn có thể truyền một chuỗi xác định khu vực trong trải nghiệm mà người chơivật của người gọi hiện đang ở.

Giá Trị Mặc Định: ""

Lợi Nhuận

()

Mẫu mã

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

()

Hiển thị quan điểm tự nhìn của người gọi. Nếu phương pháp này được gọi khi quan điểm tự nhìn đã xuất hiện, nó không làm gì cả.

Tham Số

selfViewPosition: Enum.SelfViewPosition

Vị trí để đặt cái nhìn tự thân.

Giá Trị Mặc Định: "LastPosition"

Lợi Nhuận

()

CanSendCallInviteAsync

Sinh Lợi

Trả về true nếu được cung cấp Player có thể gửi lời mời gọi cuộc gọi cho một người bạn bè.Bạn nên luôn luôn sử dụng kết quả của phương pháp này trước khi gọi PromptPhoneBook() vì khả năng mở cuốn sách điện thoại có thể thay đổi tùy thuộc vào người chơi.

Xem Kết nối Roblox để có một ví dụ thực hiện phương pháp này.

Tham Số

player: Instance

Ví dụ Player của người chơi có thể gửi lời mời gọi cuộc gọi tiềm năng.

Giá Trị Mặc Định: ""

Lợi Nhuận

Liệu người chơi được chỉ định có thể gửi lời mời gọi.

Mẫu mã

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

Sinh Lợi

CanSendGameInviteAsync() trả về true nếu Player được cung cấp có thể mời các người chơi khác vào trải nghiệm hiện tại.Bạn nên luôn luôn sử dụng kết quả của phương pháp này trước khi gọi PromptGameInvite() vì khả năng mời người chơi có thể thay đổi tùy thuộc vào nền tảng hoặc người chơi.

Xem Lời mời người chơi để có thêm chi tiết về thực hiện lời mời người chơi, tùy chỉnh lời mời và thông báo, và sử dụng dữ liệu khởi động.

Tham Số

player: Instance

Ví dụ Player của người chơi có thể gửi lời mời.

Giá Trị Mặc Định: ""

recipientId: number

Tùy chọn Player.UserId của người nhận tiềm năng **** , được sử dụng để kiểm tra xem người gửi có thể mời người nhận cụ thể đó không.

Giá Trị Mặc Định: 0

Lợi Nhuận

Liệu người chơi được chỉ định có thể gửi lời mời hay không.

Mẫu mã

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

Sinh Lợi

Tham Số

partyId: string

Giá Trị Mặc Định: ""

Lợi Nhuận

Array

Sự Kiện

CallInviteStateChanged

Sự kiện này bắt lửa khi tình trạng mời gọi của người chơi thay đổi.

Tham Số

player: Instance

Ví dụ Player của người chơi có trạng thái thay đổi khi có cuộc gọi mời.

inviteState: Enum.InviteState

Tình trạng mời gọi cuộc gọi mới.

Mẫu mã

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

Sự kiện này xảy ra khi một người chơi đóng lại một lời mời.

Tham Số

player: Instance

Ví dụ Player của người chơi đã đóng lại lời nhắc.

recipientIds: Array

Không còn được lấp đầy; một array trống.

PhoneBookPromptClosed

Bắt lửa khi một người chơi đóng lại lời nhắc danh bộ điện thoại.

Tham Số

player: Instance

Ví dụ Player của người chơi đã đóng sách điện thoại.