Monitoramento do carregamento de conteúdo — MRTK2

Progresso da operação de cena

Quando o conteúdo estiver sendo carregado ou descarregado, a SceneOperationInProgress propriedade retornará true. Você pode monitorar o progresso dessa operação por meio da SceneOperationProgress propriedade .

O SceneOperationProgress valor é a média de todas as operações de cena assíncrona atuais. No início de uma carga de conteúdo, SceneOperationProgress será zero. Depois de totalmente concluído, SceneOperationProgress será definido como 1 e permanecerá em 1 até que a próxima operação ocorra. Observe que apenas as operações de cena de conteúdo afetam essas propriedades.

Essas propriedades refletem o estado de uma operação inteira do início ao fim, mesmo que essa operação inclua várias etapas:

IMixedRealitySceneSystem sceneSystem = MixedRealityToolkit.Instance.GetService<IMixedRealitySceneSystem>();

// First do an additive scene load
// SceneOperationInProgress will be true for the duration of this operation
// SceneOperationProgress will show 0-1 as it completes
await sceneSystem.LoadContent("ContentScene1");

// Now do a single scene load
// This will result in two actions back-to-back
// First "ContentScene1" will be unloaded
// Then "ContentScene2" will be loaded
// SceneOperationInProgress will be true for the duration of this operation
// SceneOperationProgress will show 0-1 as it completes
sceneSystem.LoadContent("ContentScene2", LoadSceneMode.Single)

Exemplos de progresso

SceneOperationInProgress pode ser útil se a atividade deve ser suspensa enquanto o conteúdo está sendo carregado:

public class FooManager : MonoBehaviour
{
    private void Update()
    {
        IMixedRealitySceneSystem sceneSystem = MixedRealityToolkit.Instance.GetService<IMixedRealitySceneSystem>();

        // Don't update foos while a scene operation is in progress
        if (sceneSystem.SceneOperationInProgress)
        {
            return;
        }

        // Update foos
        ...
    }
    ...
}

SceneOperationProgress pode ser usado para exibir caixas de diálogo de progresso:

public class ProgressDialog : MonoBehaviour
{
    private void Update()
    {
        IMixedRealitySceneSystem sceneSystem = MixedRealityToolkit.Instance.GetService<IMixedRealitySceneSystem>();

        if (sceneSystem.SceneOperationInProgress)
        {
            DisplayProgressIndicator(sceneSystem.SceneOperationProgress);
        }
        else
        {
            HideProgressIndicator();
        }
    }
    ...
}

---

Monitoramento com ações

O Sistema de Cena fornece várias ações para informar quando as cenas estão sendo carregadas ou descarregadas. Cada ação retransmite o nome da cena afetada.

Se uma operação de carregamento ou descarregamento envolver várias cenas, as ações relevantes serão invocadas uma vez por cena afetada. Eles também são invocados de uma só vez quando a operação de carregamento ou descarregamento é totalmente concluída. Por esse motivo, é recomendável que você use ações OnWillUnload para detectar o conteúdo que será destruído, em vez de usar ações OnUnloaded para detectar conteúdo destruído após o fato.

Por outro lado, como as ações OnLoaded são invocadas somente quando todas as cenas são ativadas e totalmente carregadas, é garantido que o uso de ações OnLoaded para detectar e usar novo conteúdo seja seguro.

Ação	Quando ele é invocado	Cenas de Conteúdo	Cenas de iluminação	Cenas do Gerente
OnWillLoadContent	Logo antes de uma carga de cena de conteúdo	•
OnContentLoaded	Depois que todas as cenas de conteúdo em uma operação de carregamento tiverem sido totalmente carregadas e ativadas	•
OnWillUnloadContent	Logo antes de uma operação de descarregamento de cena de conteúdo	•
OnContentUnloaded	Depois que todas as cenas de conteúdo em uma operação de descarregamento tiverem sido totalmente descarregadas	•
OnWillLoadLighting	Pouco antes de uma carga de cena de iluminação		•
OnLightingLoaded	Depois que uma cena de iluminação tiver sido totalmente carregada e ativada		•
OnWillUnloadLighting	Pouco antes de uma cena de iluminação descarregar		•
OnLightingUnloaded	Depois que uma cena de iluminação tiver sido totalmente descarregada		•
OnWillLoadScene	Pouco antes de uma carga de cena	•	•	•
OnSceneLoaded	Depois que todas as cenas em uma operação forem totalmente carregadas e ativadas	•	•	•
OnWillUnloadScene	Logo antes de um descarregamento de cena	•	•	•
OnSceneUnloaded	Depois que uma cena é totalmente descarregada	•	•	•

Exemplos de ação

Outro exemplo de caixa de diálogo de progresso usando ações e uma corrotina em vez de Atualizar:

public class ProgressDialog : MonoBehaviour
{
    private bool displayingProgress = false;

    private void Start()
    {
        IMixedRealitySceneSystem sceneSystem = MixedRealityToolkit.Instance.GetService<IMixedRealitySceneSystem>();
        sceneSystem.OnWillLoadContent += HandleSceneOperation;
        sceneSystem.OnWillUnloadContent += HandleSceneOperation;
    }

    private void HandleSceneOperation (string sceneName)
    {
        // This may be invoked multiple times per frame - once per scene being loaded or unloaded.
        // So filter the events appropriately.
        if (displayingProgress)
        {
            return;
        }

        displayingProgress = true;
        StartCoroutine(DisplayProgress());
    }

    private IEnumerator DisplayProgress()
    {
        IMixedRealitySceneSystem sceneSystem = MixedRealityToolkit.Instance.GetService<IMixedRealitySceneSystem>();

        while (sceneSystem.SceneOperationInProgress)
        {
            DisplayProgressIndicator(sceneSystem.SceneOperationProgress);
            yield return null;
        }

        HideProgressIndicator();
        displayingProgress = false;
    }

    ...
}

---

Controlando a ativação da cena

Por padrão, as cenas de conteúdo são definidas para ativar quando carregadas. Se você quiser controlar a ativação da cena manualmente, poderá passar um SceneActivationToken para qualquer método de carregamento de conteúdo. Se várias cenas de conteúdo estiverem sendo carregadas por uma única operação, esse token de ativação será aplicado a todas as cenas.

IMixedRealitySceneSystem sceneSystem = MixedRealityToolkit.Instance.GetService<IMixedRealitySceneSystem>();

SceneActivationToken activationToken = new SceneActivationToken();

// Load the content and pass the activation token
sceneSystem.LoadContent(new string[] { "ContentScene1", "ContentScene2", "ContentScene3" }, LoadSceneMode.Additive, activationToken);

// Wait until all users have joined the experience
while (!AllUsersHaveJoinedExperience())
{
    await Task.Yield();
}

// Let scene system know we're ready to activate all scenes
activationToken.AllowSceneActivation = true;

// Wait for all scenes to be fully loaded and activated
while (sceneSystem.SceneOperationInProgress)
{
    await Task.Yield();
}

// Proceed with experience

---

Verificando qual conteúdo é carregado

A ContentSceneNames propriedade fornece uma matriz de cenas de conteúdo disponíveis na ordem do índice de build. Você pode marcar se essas cenas são carregadas por meio de IsContentLoaded(string contentName).

IMixedRealitySceneSystem sceneSystem = MixedRealityToolkit.Instance.GetService<IMixedRealitySceneSystem>();

string[] contentSceneNames = sceneSystem.ContentSceneNames;
bool[] loadStatus = new bool[contentSceneNames.Length];

for (int i = 0; i < contentSceneNames.Length; i++>)
{
    loadStatus[i] = sceneSystem.IsContentLoaded(contentSceneNames[i]);
}