콘텐츠 로드 모니터링 - MRTK2

장면 작업 진행률

콘텐츠를 로드하거나 언로드하는 경우 속성은 true를 SceneOperationInProgress 반환합니다. 속성을 통해 이 작업의 진행률을 모니터링할 SceneOperationProgress 수 있습니다.

값은 SceneOperationProgress 모든 현재 비동기 장면 작업의 평균입니다. 콘텐츠 로드가 시작될 때 은 SceneOperationProgress 0이 됩니다. 완전히 완료되면 는 SceneOperationProgress 1로 설정되고 다음 작업이 수행될 때까지 1로 유지됩니다. 콘텐츠 장면 작업만 이러한 속성에 영향을 줍니다.

이러한 속성은 해당 작업에 여러 단계가 포함되어 있더라도 처음부터 끝까지 전체 작업의 상태를 반영합니다.

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)

진행률 예제

SceneOperationInProgress 콘텐츠가 로드되는 동안 활동을 일시 중단해야 하는 경우 유용할 수 있습니다.

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 진행률 대화 상자를 표시하는 데 사용할 수 있습니다.

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

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

---

작업으로 모니터링

장면 시스템은 장면이 로드되거나 언로드되는 시기를 알려주는 몇 가지 작업을 제공합니다. 각 작업은 영향을 받는 장면의 이름을 릴레이합니다.

로드 또는 언로드 작업에 여러 장면이 포함된 경우 관련 작업은 영향을 받는 장면당 한 번 호출됩니다. 또한 로드 또는 언로드 작업이 완전히 완료될 때 한 번에 호출 됩니다. 이러한 이유로 OnWillUnload 작업을 사용하여 삭제 될 콘텐츠를 검색하는 것이 좋습니다. OnUnloaded 작업을 사용하여 사실 이후에 삭제된 콘텐츠를 검색하는 것과는 대조적입니다.

반대로 OnLoaded 작업은 모든 장면이 활성화되고 완전히 로드될 때만 호출되므로 OnLoaded 작업을 사용하여 새 콘텐츠를 검색하고 사용하는 것이 안전합니다.

작업	호출되는 경우	콘텐츠 장면	조명 장면	관리자 장면
OnWillLoadContent	콘텐츠 장면 로드 직전에	•
OnContentLoaded	로드 작업의 모든 콘텐츠 장면이 완전히 로드되고 활성화된 후	•
OnWillUnloadContent	콘텐츠 장면 언로드 작업 직전에	•
OnContentUnloaded	언로드 작업의 모든 콘텐츠 장면이 완전히 언로드된 후	•
OnWillLoadLighting	조명 장면 로드 직전		•
OnLightingLoaded	조명 장면이 완전히 로드되고 활성화된 후		•
OnWillUnloadLighting	조명 장면 언로드 직전		•
OnLightingUnloaded	조명 장면이 완전히 언로드된 후		•
OnWillLoadScene	장면 로드 직전	•	•	•
OnSceneLoaded	작업의 모든 장면이 완전히 로드되고 활성화된 후	•	•	•
OnWillUnloadScene	장면 언로드 직전	•	•	•
OnSceneUnloaded	장면이 완전히 언로드된 후	•	•	•

작업 예제

업데이트 대신 작업 및 코루틴을 사용하는 또 다른 진행률 대화 상자 예:

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;
    }

    ...
}

---

장면 활성화 제어

기본적으로 콘텐츠 장면은 로드될 때 활성화되도록 설정됩니다. 장면 활성화를 수동으로 제어하려는 경우 을 SceneActivationToken 모든 콘텐츠 로드 메서드에 전달할 수 있습니다. 단일 작업으로 여러 콘텐츠 장면을 로드하는 경우 이 활성화 토큰은 모든 장면에 적용됩니다.

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

---

로드되는 콘텐츠 확인

속성은 ContentSceneNames 빌드 인덱스 순서대로 사용 가능한 콘텐츠 장면의 배열을 제공합니다. 이러한 장면이 를 통해 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]);
}