Trình theo dõi bạn bè

Có thể khó để tìm thấy bạn bè trong kinh nghiệm. The FriendsLocator module developer cho phép người chơi dễ dàng tìm thấy và dịch chuyển đến bạn bè của họ trong một địa điểm.

Sử dụng mô-đun

Cài đặt

Để sử dụng mô-đun FriendsLocator trong một trải nghiệm:

1. Từ trang Xem, mở trang Hộp công cụ và chọn trang Cửa hàng Creator .

   

2. Đảm bạn chắn chọn Mô Hình sắp xếp, then click the Xem tất cả button for Các danh mục .

   

3. Tìm và nhấp vào Dev Modules mảnh.

   

4. Tìm mô-đun Locate the Friends Locator và nhấp vào nó, hoặc kéo nó vào 3D view.

   

5. Trong cửa sổ Explorer, di chuyển toàn bộ mô hình FriendsLocator đến ServerScriptService . Khi chạy trải nghiệm, mô hình sẽ được phân phối đến các dịch vụ khác nhau và bắt đầu chạy.

   

Làm việc trong Studio

Để kiểm tra modul ở Studio, modul FriendsLocator phải được thiết lập trong một mô phỏng nhiều khách hàng, vì không có bạn bè nào sẽ hiện diện trong một lần chơi solo.

1. Trong StarterPlayerScripts , tạo một LocalScript mới và đổi tên nó thành ConfigureFriendsLocator .

   

2. Hãy vẽ mã sau đây vào trong đoạn mã mới ConfigureFriendsLocator . Cài đặt showAllPlayers trong hành động configure đảm bảo rằng các máy định vị được hiển thị cho tất cả người dùng trong khi thử nghiệm ở Studio, nhưng không phải ở địa điểmcông bố.

   LocalScript - Tùy chỉnh FriendsLocator
   local RunService = game:GetService("RunService")
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))
   
   FriendsLocator.configure({
   	showAllPlayers = RunService:IsStudio(),  -- Cho phép debug ở Studio
   })

3. Từ trang Thử nghiệm, chọn các lựa chọn sau đây cho Clients và Servers , sau đó nhấp vào nút Bắt đầu . Ba instância mới của Studio sẽ mở; một máy chủ simulado và hai máy khách simulado.

   

4. Vào một trong những instances client Studio , di chuyển một khoảng cách 100 studs khỏi nhân vật khác, và bạn nên thấy một biểu tượng locator hiện ra trên đầu của nó.

   

   Do cách mà ID người dùng được xử lý trong Studio, hình ảnh avatar sẽ không xuất hiện trên các biểu tượng bản đồ trong khi chạy thử nghiệm.

   Bởi mặc định, nhấp vào/nhấp vào icon của một người bạn bèsẽ dịch chuyển nhân vật của bạn đến vị trí của người bạn đó. Nếu bạn giữ nguyên tắc này và bạn tìm thấy rằng dịch chuyển dừng đang diễn ra dưới kie</

Kết Nối với Sự Kiện

Modul FriendsLocator tiết lộ sự kiện để bạn có thể giới thiệu các hành vi tùy chỉnh khi người dùng tương tác với một biểu tượng locator.

1. Hãy đảm bảo rằng bạn đã tạo ra ConfigureFriendsLocator script được mô tả trong Testing in Studio .

2. Thêm dòng 8 và 11-13 vào kịch bản:

   LocalScript - Tùy chỉnh FriendsLocator
   local RunService = game:GetService("RunService")
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))
   
   FriendsLocator.configure({
   	showAllPlayers = RunService:IsStudio(),  -- Cho phép debug ở Studio
   	teleportToFriend = false,  -- Ngăn chặn dịch chuyển trên màn hình nhấp chuột/nhấp chuột
   })
   
   FriendsLocator.clicked:Connect(function(player, playerCFrame)
   	print("You clicked on locator icon for", player.DisplayName)
   end)

3. Thực hiện một cuộc kiểm tra nhiều khách hàng và nhấp vào biểu tượng nhịp của một nhân vật khác. Lưu ý rằng nhân vật của bạn không dịch chuyển đến vị trí đó, và sự kiện trích dẫn để cho phép điều khiển tùy chỉnh của những lần nhấp chuột icon.

Giao diện người dùng định vị tùy chỉnh

Nếu kiểu dáng mặc định không phù hợp với trải nghiệm của bạn, bạn có thể thay thế UI bức tranh avatar mặc định bằng UI của riêng bạn.

Để thay thế UI mặc định:

1. Tạo một đối tượng mới ScreenGui trong StarterGui container.

   

2. Tạo một Frame instance tên FriendLocator như một con của ScreenGui mới, sau đó thêm các thành phần như 1> Class.ImageLabel|ImageLabels1> , 4> Class.TextLabel|TextLabels4> để thiết kế UI tùy chỉnh củ

   

3. Khi hoàn thành, vô hiệu hóa phụ huynh ScreenGui để modül không hiển thị UI locator tùy chỉnh cho đến khi cần thiết.

   

4. (Tùy chọn) Nếu bạn muốn bức tranh avatar của bạn bè và DisplayName để xuất hiện ở một nơi trong UI tùy chỉnh, bạn có thể đặt các instance này vào khung FriendLocator bên trong.

   • Một ImageLabel của tên Hình ảnh của các cầu thủ .
   • Một TextLabel của tên DisplayName .

   

   Chức năng này sẽ tìm kiếm các mục này và hiển thị bức vẽ avatar của bạn bè và / hoặc tên hiển thị tương ứng.

Tham khảo API

Hàm

điều chỉnh

Làm mất các lựa chọn cài đặt mặc định qua các chìa khóa/giá trị dưới đây trong bảng config .

LocalScript - Tùy chỉnh FriendsLocator
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

FriendsLocator.configure({
	alwaysOnTop = true,
	showAllPlayers = false,
	teleportToFriend = true,
	thresholdDistance = 100,
	maxLocators = 10
})

Sự kiện

đã nhấp

Kích hoạt khi một biểu tượng bộ lọc được nhấp chuột/bật bởi người chơi địa phương. Sự kiện này chỉ có thể kết nối trong một LocalScript .

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

local localPlayer = Players.LocalPlayer

FriendsLocator.clicked:Connect(function(player, playerCFrame)
	-- Yêu cầu phát sóng xung quanh vị trí mục tiêu
	if workspace.StreamingEnabled then
		local success, errorMessage = pcall(function()
			localPlayer:RequestStreamAroundAsync(playerCFrame.Position)
		end)
		if not success then
			print(errorMessage)
		end
	end

	print("You clicked on locator icon for", player.DisplayName, "at position", playerCFrame.Position)
end)

đã thay đổi

Kích hoạt khi một biểu tượng bộ lọc được hiển thị/ẩn trên màn hình người chơi địa phương. Sự kiện này chỉ có thể được kết nối trong một LocalScript .

Script địa phương
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

FriendsLocator.visibilityChanged:Connect(function(player, playerCFrame, isVisible)
	print("Visibility of locator icon for", player.DisplayName, ":", isVisible)
end)