Huy hiệu | Tài liệu - Trung Tâm Nhà Sáng Tạo Roblox

Một huy hiệu là một giải thưởng đặc biệt mà bạn có thể tặng cho người chơi khi họ đạt được một mục tiêu trong trò chơi của bạn, chẳng hạn như hoàn thành một nhiệm vụ khó khăn hoặc chơi trong một khoảng thời gian nhất định. Ngay khi một người chơi nhận được huy hiệu, nó sẽ hiển thị trong danh mục Huy hiệu trong kho của họ.

Ví dụ về huy hiệu trong kho của người chơi

Tạo huy hiệu

Bạn có thể tạo tối đa 5 huy hiệu miễn phí trong một khoảng thời gian 24 giờ (GMT) cho mỗi trò chơi mà bạn sở hữu. Nếu bạn muốn tạo thêm trong khoảng thời gian 24 giờ này, mỗi huy hiệu bổ sung sẽ tốn 100 Robux.

Để tạo một huy hiệu:

Điều hướng đến Bảng điều khiển Nhà phát triển.
Di chuột qua hình thu nhỏ của một trò chơi, nhấp vào nút ⋯ và chọn Tạo Huy hiệu.
Trên trang tạo, nhấp vào nút Tải lên Hình ảnh và sau đó chọn/xác nhận hình ảnh mà bạn muốn sử dụng làm biểu tượng của huy hiệu. Khi tạo một hình ảnh để sử dụng cho huy hiệu, hãy xem xét những điều sau:
- Sử dụng một mẫu có kích thước 512×512 pixel.
- Quy trình tải lên cắt và cắt hình ảnh huy hiệu thành một biểu tượng hình tròn, vì vậy tránh đặt các chi tiết quan trọng bên ngoài ranh giới hình tròn.
  
  Nội dung chính đã được bao gồm
  Nội dung văn bản bị cắt
Hoàn thành các trường sau:
- Tên — Tiêu đề cho huy hiệu.
- Mô tả — Một mô tả về những gì người chơi có thể làm để kiếm được huy hiệu.
- Huy hiệu được Bật — Liệu huy hiệu có được bật khi nó được tạo ra hay không. Huy hiệu bị tắt sẽ không được hiển thị trong phần Huy hiệu của trang chính trò chơi và không thể được người chơi kiếm được.
Nhấp vào nút Tạo Huy hiệu. Huy hiệu mới sẽ hiển thị trong phần Tham gia ⟩ Huy hiệu trên Bảng điều khiển Nhà phát triển. Nếu huy hiệu mới được bật, nó cũng sẽ được hiển thị trong phần Huy hiệu của trang chính trò chơi.

Huy hiệu trên trang chính của trò chơi

Sắp xếp lại huy hiệu

Khi một huy hiệu được tạo lần đầu tiên, nó sẽ được đặt ở cuối danh sách huy hiệu. Bạn có thể sắp xếp lại tối đa 50 huy hiệu cùng một lúc bằng cách sử dụng giao diện kéo và thả.

Để sắp xếp lại huy hiệu:

Điều hướng đến trò chơi liên quan.
Trong bảng điều khiển bên dưới tiêu đề Tham gia, điều hướng đến trang Huy hiệu.
Chọn Sắp xếp lại để điều hướng đến trang sắp xếp lại.
Trên trang sắp xếp lại, kéo và thả các huy hiệu vào thứ tự mà bạn mong muốn.
Chọn Lưu để lưu thứ tự này. Thứ tự đã chỉ định nên xuất hiện trên trang chi tiết trò chơi.

Kịch bản huy hiệu

Các quy trình lập trình huy hiệu phổ biến bao gồm tặng huy hiệu, kiểm tra xem người chơi đã kiếm được huy hiệu trong trò chơi của bạn chưa, và lấy thông tin huy hiệu.

Xác định ID huy hiệu

ID của một huy hiệu là định danh duy nhất của nó. Bạn sẽ cần ID này khi thực hiện các quy trình như tặng huy hiệu cho một người chơi.

Trên Bảng điều khiển Nhà phát triển, điều hướng đến phần Huy hiệu của trò chơi liên kết dưới Tham gia.
Di chuột qua hình thu nhỏ của một huy hiệu, nhấp vào nút ⋯ và chọn Sao chép ID Tài sản từ menu ngữ cảnh.

Tặng huy hiệu

Bạn có thể tặng huy hiệu cho người chơi trong suốt trò chơi của bạn bằng cách gọi phương thức BadgeService:AwardBadgeAsync() trong một Script phía máy chủ. BadgeService:GetBadgeInfoAsync() trả về các thuộc tính của huy hiệu, bao gồm IsEnabled xác nhận liệu huy hiệu có thể được tặng cho người chơi hay không. Bạn có thể bật hoặc tắt một huy hiệu từ biểu mẫu Cấu hình Huy hiệu trên Bảng điều khiển Nhà phát triển.

Dưới đây là một ví dụ về một hàm an toàn để tặng huy hiệu cho người chơi.


local BadgeService = game:GetService("BadgeService")

local function awardBadge(player, badgeId)
	-- Lấy thông tin huy hiệu
	local success, badgeInfo = pcall(function()
		return BadgeService:GetBadgeInfoAsync(badgeId)
	end)

	if success then
		-- Xác nhận rằng huy hiệu có thể được tặng
		if badgeInfo.IsEnabled then
			-- Tặng huy hiệu
			local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
			if not awarded then
				warn("Lỗi khi tặng huy hiệu:", errorMessage)
			end
		end
	else
		warn("Lỗi khi lấy thông tin huy hiệu: " .. badgeInfo)
	end
end

Kiểm tra huy hiệu đã kiếm được

Kịch bản sau kiểm tra khi bất kỳ người chơi nào vào trò chơi, sau đó sử dụng phương thức BadgeService:UserHasBadgeAsync() để xác nhận xem người chơi đó có sở hữu huy hiệu với ID tương ứng được đặt trong biến BADGE_ID không. Bạn cũng có thể xác minh quyền sở hữu huy hiệu theo lô bằng cách sử dụng phương thức BadgeService:CheckUserBadgesAsync().


local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")

local BADGE_ID = 00000000  -- Thay đổi này thành ID huy hiệu của bạn

local function onPlayerAdded(player)
  -- Kiểm tra xem người chơi có huy hiệu hay không
	local success, hasBadge = pcall(BadgeService.UserHasBadgeAsync, BadgeService, player.UserId, BADGE_ID)

  -- Nếu có lỗi, phát ra cảnh báo và thoát khỏi hàm
	if not success then
		warn("Lỗi khi kiểm tra xem người chơi có huy hiệu không")
		return
	end

	if hasBadge then
		-- Xử lý quyền sở hữu huy hiệu của người chơi nếu cần
	end
end

-- Kết nối các sự kiện "PlayerAdded" với hàm "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)

Lấy thông tin huy hiệu

Để lấy thông tin về một huy hiệu, chẳng hạn như mô tả hoặc ID tài sản biểu tượng của nó, gọi phương thức BadgeService:GetBadgeInfoAsync() với một ID huy hiệu. Ví dụ:


local BadgeService = game:GetService("BadgeService")

local BADGE_ID = 00000000  -- Thay đổi này thành ID huy hiệu của bạn

-- Lấy thông tin huy hiệu
local success, result = pcall(BadgeService.GetBadgeInfoAsync, BadgeService, BADGE_ID)

-- Xuất thông tin
if success then
	print("Huy hiệu:", result.Name)
	print("Bật:", result.IsEnabled)
	print("Mô tả:", result.Description)
	print("Biểu tượng:", "rbxassetid://" .. result.IconImageId)
else
	warn("Lỗi khi lấy thông tin huy hiệu:", result)
end