Huy hiệu

*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

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

Example badges in a player's inventory
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 vòng 24 giờ (GMT) cho mỗi trải nghiệm bạn sở hữu.Nếu bạn muốn tạo thêm trong khoảng thời gian 24 giờ, mỗi huy hiệu bổ sung có giá 100 Robux.

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

  1. Điều hướng đến Bảng điều khiển Nhà sáng tạo.

  2. Vượt qua hình nhỏcủa một trải nghiệm, nhấp vào nút ⋯ và chọn Tạo Huy hiệu .

  3. Trên trang tạo, nhấp vào nút Tải hình ảnh và sau đó chọn/xác nhận hình ảnh 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 một huy hiệu, hãy xem xét những theo dõi:

    • Sử dụng một mẫu của 512×512 pixels .

    • Quá 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 tròn, vì vậy tránh đặt các chi tiết quan trọng ngoài giới hạn tròn.

      Good circular trimming
      Bad circular trimming

  4. Hoàn thành các trường sau:

    • Tên — Một 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 hay không khi nó được tạo ra.Huy hiệu bị vô hiệu hóa không được hiển thị dưới phần Huy hiệu của trang chủ của trải nghiệm và không thể kiếm được bởi người chơi.

  5. Nhấp vào nút Tạo Huy hiệu .Huy hiệu mới hiển thị trong phần Tham gia > Huy hiệu trong phần Bảng điều khiển Nhà sáng tạo .Nếu thẻ mới được bật, nó cũng sẽ được hiển thị dưới phần Huy hiệu của trang chủ của trải nghiệm.

    Huy hiệu trên trang chính của trải nghiệm

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

Khi một huy hiệu được tạo lần đầu tiên, nó đượ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 giao diện kéo và thả.

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

  1. Di chuyển đến trải nghiệm liên quan.

  2. Trong thanh bên bên dưới tiêu đề Tham gia , hãy di chuyển đến trang Huy hiệu .

  3. Chọn Sắp xếp lại để điều hướng đến trang sắp xếp lại.

    Badge reorder button

  4. Trên trang sắp xếp lại, kéo và thả huy hiệu vào trật tự ưa thích của chúng.

    Badge drag-and-drop to reorder

  5. Chọn Lưu để lưu trật tự này. Trật tự đã được xác định nên xuất hiện trên trang chi tiết trải nghiệm.

Huy hiệu kịch bản

Các luồng công việc lập trình huy hiệu phổ biến bao gồm trao huy hiệu, kiểm tra xem một người chơi có trước đó kiếm được một huy hiệu trong trải nghiệm của bạn, và nhận thông tin huy hiệu .

Tìm ID huy hiệu

ID của một huy hiệu là nhận dạng duy nhất của nó. Bạn sẽ cần ID này khi triển khai công việc như trao huy hiệu cho một người chơi.

  1. Trên trang Bảng điều khiển Nhà sáng tạo, hãy di chuyển đến phần Huy hiệu của trải nghiệm liên quan dưới Sự tham gia .

  2. Vượt qua hình ảnh hình 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.

Huy hiệu giải thưởng

Bạn có thể trao huy hiệu cho người chơi trong suốt trải nghiệm của bạn bằng cách gọi phương pháp BadgeService:AwardBadge() ở bên máy chủ Script.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 trao cho một 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 Tùy chỉnh huy hiệu trên Bảng điều khiển Nhà sáng tạo.

Cái sau là một ví dụ về chức năng an toàn để trao 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(BadgeService.GetBadgeInfoAsync, BadgeService, badgeId)

  if success then

    -- Xác nhận rằng huy hiệu có thể được trao

    if badgeInfo.IsEnabled then

      -- huy hiệugiải thưởng

      local awarded, errorMessage = pcall(BadgeService.AwardBadge, BadgeService, player.UserId, badgeId)

      if not awarded then

        warn("Error while awarding badge:", errorMessage)

      end

    end

  else

 	  warn("Error while fetching badge info!")

  end

end

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

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

local BadgeService = game:GetService("BadgeService")

local Players = game:GetService("Players")



local BADGE_ID = 00000000  -- Thay đổi điều 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 chức năng

	if not success then

		warn("Error while checking if player has badge")

		return

	end



	if hasBadge then

		-- Xử lý sở hữu huy hiệu của người chơi theo yêu cầu

	end

end



-- Kết nối sự kiện "PlayerAdded" với chức năng "onPlayerAdded()"

Players.PlayerAdded:Connect(onPlayerAdded)

Nhận thông tin huy hiệu

Để nhận thông tin về một huy hiệu, chẳng hạn như mô tả hoặc ID tài nguyên biểu tượng, hãy gọi phương pháp với ID huy hiệu . Ví dụ:

local BadgeService = game:GetService("BadgeService")



local BADGE_ID = 00000000  -- Thay đổi điều 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("Badge:", result.Name)

	print("Enabled:", result.IsEnabled)

	print("Description:", result.Description)

	print("Icon:", "rbxassetid://" .. result.IconImageId)

else

	warn("Error while fetching badge info:", result)

end