Classe de moteur
BadgeService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Résumé
Méthodes
AwardBadge(userId: User,badgeId: number):boolean |
AwardBadgeAsync(userId: User,badgeId: number):boolean |
CheckUserBadgesAsync(userId: User,badgeIds: {any}):{any} |
GetBadgeInfoAsync(badgeId: number):Dictionary |
IsDisabled(badgeId: number):boolean |
UserHasBadge(userId: User,badgeId: number):boolean |
UserHasBadgeAsync(userId: User,badgeId: number):boolean |
Référence API
Méthodes
AwardBadge
AwardBadgeAsync
Retours
Échantillons de code
Attribution d'un badge
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local BADGE_ID = 0
local function awardBadge(player, badgeId)
-- Récupérer les informations sur le badge
local success, badgeInfo = pcall(function()
return BadgeService:GetBadgeInfoAsync(badgeId)
end)
if success then
-- Confirmer que le badge peut être attribué
if badgeInfo.IsEnabled then
-- Attribuer le badge
local awarded, errorMessage = pcall(BadgeService.AwardBadgeAsync, BadgeService, player.UserId, badgeId)
if not awarded then
warn("Erreur lors de l'attribution du badge :", errorMessage)
end
end
else
warn("Erreur lors de la récupération des informations sur le badge : " .. badgeInfo)
end
end
local function onPlayerAdded(player)
awardBadge(player, BADGE_ID)
end
Players.PlayerAdded:Connect(onPlayerAdded)CheckUserBadgesAsync
Retours
Échantillons de code
Vérification des Badges Gagnés par Lots
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local badgeIds = { 0000000000, 1111111111, 2222222222 } -- Changez ceci par une liste de vos ID de badge
local function onPlayerAdded(player)
-- Vérifiez si le joueur a des badges
local success, result = pcall(function()
return BadgeService:CheckUserBadgesAsync(player.UserId, badgeIds)
end)
-- S'il y a une erreur, émettez un avertissement et sortez de la fonction
if not success then
warn("Erreur lors de la vérification si le joueur", player.Name, "a des badges:", result)
return
end
local ownedBadgeIds = result
if #ownedBadgeIds == 0 then
print(player.Name, "n'a aucun des badges")
else
print(player.Name, "a les badges suivants:", table.concat(ownedBadgeIds, ", "))
end
end
Players.PlayerAdded:Connect(onPlayerAdded)GetBadgeInfoAsync
Paramètres
Retours
Échantillons de code
Obtenir des informations sur le badge
local BadgeService = game:GetService("BadgeService")
-- Récupérer les informations sur le badge
local success, result = pcall(function()
return BadgeService:GetBadgeInfoAsync(00000000) -- Changez ceci pour l'ID du badge souhaité
end)
-- Afficher les informations
if success then
print("Badge:", result.Name)
print("Activé:", result.IsEnabled)
print("Description:", result.Description)
print("Icône:", "rbxassetid://" .. result.IconImageId)
else
warn("Erreur lors de la récupération des informations sur le badge:", result)
endIsDisabled
IsLegal
UserHasBadge
UserHasBadgeAsync
Retours
Échantillons de code
Vérification des badges obtenus
local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")
local badgeId = 00000000 -- Changez cela avec l'ID de votre badge
local function onPlayerAdded(player)
-- Vérifiez si le joueur a le badge
local success, hasBadge = pcall(function()
return BadgeService:UserHasBadgeAsync(player.UserId, badgeId)
end)
-- S'il y a une erreur, émettez un avertissement et quittez la fonction
if not success then
warn("Erreur lors de la vérification si le joueur a le badge!")
return
end
if hasBadge then
-- Traitez la possession du badge par le joueur selon les besoins
print(player.Name, "a le badge", badgeId)
end
end
-- Connectez les événements "PlayerAdded" à la fonction "onPlayerAdded()"
Players.PlayerAdded:Connect(onPlayerAdded)