Componente de ícone de item no Fortnite | Fortnite Documentação

Esta funcionalidade está em estado experimental, então você pode testá-la, fornecer feedback e ver o que estamos planejando. No momento, não é possível publicar um projeto que utilize itemização.

Lembre-se de que não garantimos a retrocompatibilidade de ativos criado em um estágio experimental, as APIs para essas funcionalidades podem sofrer alterações e podemos remover completamente funcionalidades experimentais ou uma funcionalidade específica a nosso critério. Confira a lista de problemas conhecidos antes de começar a trabalhar com a funcionalidade.

O item_icon_component é um componente do Scene Graph usado para atribuir um ícone a uma entidade. Para saber como adicionar um componente à sua entidade, consulte Como trabalhar com entidades e componentes.

As entidades serão consideradas itens apenas se tiverem um item_component. Sem um, as entidades não serão adicionadas aos inventários adequadamente, bem como a funcionalidade de itens e inventários personalizados pode ser interrompida.

Referências a um "item" estão se referindo a uma entidade com um item_component.
As referências a "inventários" referem-se a uma entidade com um inventory_component.

Descrição da Classe

Um item_icon_component usa um ativo de textura como referência visual para o item no jogo. O item_icon_component também permite o controle da textura por meio de variáveis e funções no sistema de Itens e Inventários Personalizados.

A propriedade do componente é <protected> e só pode ser modificada na instanciação ou criando uma subclasse do componente e definindo-o dentro da subclasse.

Depois que o sistema de itens e inventários personalizados é ativado, o item_icon_component é listado na lista suspensa de componentes. Para obter mais informações, confira a referência da API item_icon_component da API do Verse.

Exemplo

Com Verse, o item_icon_component pode receber um valor por meio do espaço de textura do componente nas opções do usuário. A textura pode ser atualizada usando um programa para detectar quando o item é removido do espaço de itens do inventário.

Você pode usar os exemplos abaixo para configurar o item_icon_component no seu projeto usando Verse.

Verse

using { /Verse.org/Assets }
using { /Fortnite.com/Devices }
using { /Fortnite.com/Itemization }
using { /Verse.org/SceneGraph }
using { /UnrealEngine.com/Itemization }
using { /UnrealEngine.com/Temporary/UI }
using { /Verse.org/Simulation }


# This device will create an item entity with an item_icon_component.

Abaixo está um exemplo de como converter a textura dentro do item_icon_component em um widget exibido usando a IU Verse.

Verse

# This function will display a texture block widget to the player screen.
# It sources the texture from the item_icon_component from the provided entity.
DisplayIconWidget(Player:player, Item:entity):void=
    if:
        IconComponent := Item.GetComponent[item_icon_component]
        PlayerUI := GetPlayerUI[Player]
    then:
        IconWidget := texture_block{DefaultImage:= IconComponent.Icon}
        PlayerUI.AddWidget(IconWidget)

# This function will display a texture block widget to the player screen.
# It sources the texture from the item_icon_component from the provided entity.
DisplayIconWidget(Player:player, Item:entity):void=
    if:
        IconComponent := Item.GetComponent[item_icon_component]
        PlayerUI := GetPlayerUI[Player]
    then:
        IconWidget := texture_block{DefaultImage:= IconComponent.Icon}
        PlayerUI.AddWidget(IconWidget)

Para saber mais sobre como usar Verse para criar interfaces de usuário (IU), consulte Como criar IU com Verse.