AppCallbacks 클래스 레퍼런스

AppCallbacks 클래스를 사용하여 메인 애플리케이션을 Unity 엔진에 연결할 수 있습니다.

예시:AppCallbacks 클래스 사용 방법

App.xaml.cpp 파일

App::App()
{
    InitializeComponent();
    SetupOrientation();
    m_AppCallbacks = ref new AppCallbacks();
}

void App::OnLaunched(LaunchActivatedEventArgs^ e)
{
    m_SplashScreen = e->SplashScreen;
    InitializeUnity(e->Arguments);
}

void App::InitializeUnity(String^ args)
{
    ApplicationView::GetForCurrentView()->SuppressSystemOverlays = true;

    m_AppCallbacks->SetAppArguments(args);
    auto rootFrame = safe_cast<Frame^>(Window::Current->Content);

    // Do not repeat app initialization when the Window already has content,
    // just ensure that the window is active
    if (rootFrame == nullptr && !m_AppCallbacks->IsInitialized())
    {
        rootFrame = ref new Frame();
        Window::Current->Content = rootFrame;
# if !UNITY_HOLOGRAPHIC
        Window::Current->Activate();
# endif

        rootFrame->Navigate(TypeName(MainPage::typeid ));
    }

    Window::Current->Activate();
}

MainPage.xaml.cpp 파일

MainPage::MainPage()
{
    m_SplashScreenRemovalEventToken.Value = 0;
    m_OnResizeRegistrationToken.Value = 0;

    InitializeComponent();
    NavigationCacheMode = ::NavigationCacheMode::Required;

    auto appCallbacks = AppCallbacks::Instance;

    bool isWindowsHolographic = false;

# if UNITY_HOLOGRAPHIC
    // If application was exported as Holographic check if the device actually supports it
    // Otherwise, we treat this as a normal XAML application
    isWindowsHolographic = AppCallbacks::IsMixedRealitySupported();
# endif

    if (isWindowsHolographic)
    {
        appCallbacks->InitializeViewManager(Window::Current->CoreWindow);
    }
    else
    {
        m_SplashScreenRemovalEventToken = appCallbacks->RenderingStarted += ref new RenderingStartedHandler(this, &MainPage::RemoveSplashScreen);

        appCallbacks->SetSwapChainPanel(m_DXSwapChainPanel);
        // Subscribes to all needed system events
        appCallbacks->SetCoreWindowEvents(Window::Current->CoreWindow);

        // This is the main initialization function for Unity
        // Initializes engine graphics, DirectX, and gamepad and joystick input
        // Loads IL2CPP and all engine subsystems except graphics
        appCallbacks->InitializeD3DXAML();
        // At this point, when Unity finishes loading the first level, it enters the main loop.

        m_SplashScreen = safe_cast<App^>(App::Current)->GetSplashScreen();

        auto dispatcher = CoreWindow::GetForCurrentThread()->Dispatcher;
        ThreadPool::RunAsync(ref new WorkItemHandler([this, dispatcher](IAsyncAction^)
        {
            GetSplashBackgroundColor(dispatcher);
        }));

        OnResize();

        m_OnResizeRegistrationToken = Window::Current->SizeChanged += ref new WindowSizeChangedEventHandler([this](Object^, WindowSizeChangedEventArgs^)
        {
            OnResize();
        });
    }
}

앱 스레드 생성

Unity는 대용량 앱을 로드할 때 UI가 응답하지 않을 수 있으므로 UI 스레드에서 앱을 실행하지 않습니다.UI 스레드에 대한 자세한 내용은 UI 스레드 응답성 유지에 대한 Microsoft의 문서를 참조하십시오.

m_AppCallbacks = ref new AppCallbacks();를 사용하여 AppCallbacks 클래스를 생성하면 Unity는 App Thread라는 새 스레드를 생성합니다.애플리케이션이 5초 후에 응답하지 않으면 Windows App Certification Kit 테스트를 통과하지 못한다는 Microsoft의 제한 사항으로 인해 Unity는 이 새 스레드를 생성합니다.자세한 내용은 Windows App Certification Kit에 대한 Microsoft의 문서를 참조하십시오.

참고:InvokeOnAppThread 함수에서 호출되지 않는 한 App.xaml.cpp 및 MainPage.xaml.cpp 파일에 있는 코드는 항상 UI 스레드에서 실행됩니다.

커맨드 라인 인자

커스텀 커맨드 라인 인자를 문자열 배열로 AppCallbacks 생성자에 전달할 수 있습니다.자세한 내용은 UWP 커맨드 라인 인자를 참조하십시오.

AppCallbacks 함수

추가 리소스

• UI 스레드 응답성 유지에 대한 Microsoft의 문서
• UWP 커맨드 라인 인자
• 커맨드 라인 인자