Caixa de diálogo — MRTK3

As caixas de diálogo são exibições de interface do usuário de curta duração que fornecem informações contextuais do aplicativo. Muitas vezes, eles solicitam alguma ação do usuário e retornam o resultado de volta à lógica de negócios do aplicativo em uma tarefa ou resultado assíncrono. Use caixas de diálogo para notificar os usuários sobre informações importantes ou solicitar confirmação antes que uma ação possa ser concluída.

Se você estiver procurando a documentação da API de Caixa de Diálogo e os exemplos de uso, consulte a documentação do UXCore aqui..

Pré-fabricados

Os componentes de UX do MRTK3 fornecem CanvasDialog.prefab como ponto de partida para a criação de caixas de diálogo modais responsivas e controladas por código.

A pré-fabricado Caixa de Diálogo baseada em Tela usa o layout automático para mostrar apenas os controles solicitados por meio da API do IDialog construtor fluente. Até que os subcontroles sejam solicitados pelo chamador de API, eles serão desabilitados e não ficarão visíveis no layout. Como resultado, apenas um prefab dialog é necessário, em vez de uma ampla variedade de pré-fabricados para cada permutação de opções de botão ou layout de texto.

Para usar a caixa de diálogo Componentes de UX pré-fabricados, verifique se você DialogPool tem o pré-fabricado definido como o ativo correto. Você também pode atribuir o DialogPoolprefab do em runtime por meio da DialogPool API, por meio do Get parâmetro ou definindo diretamente a DialogPrefab propriedade . Consulte a documentação da API de Caixa de Diálogo aqui para obter exemplos de como usar o componente DialogPool.

Os desenvolvedores também podem criar seus próprios pré-fabricados personalizados da Caixa de Diálogo. Se o prefab personalizado oferecer os mesmos recursos que a funcionalidade de caixa de diálogo base, nenhuma alteração de código será necessária e o script base Dialog poderá ser usado. Se houver recursos adicionados na exibição Caixa de Diálogo que exigem associação IDialog à API (como novos botões, rótulos ou outros subcontroles), uma implementação subclasse de IDialog será necessária. Ao criar um pré-fabricado personalizado, verifique se os vários subcontroles foram referenciados corretamente no IDialog MonoBehaviour ou se eles não serão associados ou hidratados corretamente.

Cenas de exemplo

Consulte DialogExample.unity para obter exemplos de como gerar caixas de diálogo. Para obter mais informações, exemplos de código e detalhes, consulte a documentação do UXCore aqui..