QQmlIncubator Class

자세한 설명

뷰의 델리게이트 또는 애플리케이션의 새 페이지와 같은 QML 개체를 만드는 데는 특히 리소스가 제한된 모바일 장치에서 상당한 시간이 걸릴 수 있습니다. 애플리케이션에서 QQmlComponent::create()를 직접 사용하는 경우 QML 개체 인스턴스가 동기식으로 생성되므로 개체의 복잡성에 따라 애플리케이션이 눈에 띄게 일시 중지되거나 끊어질 수 있습니다.

QQmlIncubator를 사용하면 애플리케이션 유휴 시간을 사용하여 비동기적으로 생성할 수 있는 등 QML 객체 생성을 보다 효과적으로 제어할 수 있습니다. 다음 예는 QQmlIncubator의 간단한 사용법을 보여줍니다.

// Initialize the incubator
QQmlIncubator incubator;
component->create(incubator);

인큐베이터를 잠시 동안 실행한 다음(일반적으로 이벤트 루프에 제어권을 반환하여) 폴링합니다. 나중에 인큐베이터로 돌아가는 방법에는 여러 가지가 있습니다. QQuickWindow 에서 보내는 신호 중 하나에 연결하거나 QTimer 을 특별히 실행할 수 있습니다. 특정 목적을 위해 개체가 필요하고 그 목적이 발생하면 인큐베이터를 폴링할 수도 있습니다.

// Poll the incubator
if (incubator.isReady()) {
    QObject *object = incubator.object();
    // Use created object
}

비동기 인큐베이터는 QQmlEngine 에 설정된 QQmlIncubationController 에 의해 제어되며, 이는 애플리케이션이 유휴 상태이고 인큐베이팅 중인 오브젝트를 처리해야 할 때를 엔진에 알려줍니다. 인큐베이션 컨트롤러가 QQmlEngine 에 설정되어 있지 않으면 QQmlIncubator 은 지정된 IncubationMode 에 관계없이 오브젝트를 동기식으로 생성합니다. 기본적으로 인큐베이션 컨트롤러는 설정되어 있지 않습니다. 그러나 QQuickView, QQuickWindow 및 QQuickWidget 는 모두 각각의 QQmlEngine에 인큐베이션 컨트롤러를 설정합니다. 이러한 인큐베이션 컨트롤러는 뷰가 렌더링되는 동안 여러 프레임에 걸쳐 인큐베이션을 분산시킵니다.

QQmlIncubator는 세 가지 인큐베이션 모드를 지원합니다:

• 동기식 생성은 동기적으로 이루어집니다. 즉, QQmlComponent::create() 호출이 반환되면 인큐베이터는 이미 오류 또는 준비 상태에 있습니다. 동기식 인큐베이터는 QQmlComponent 에서 직접 동기식 생성 방법을 사용하는 것에 비해 실질적인 이점은 없지만 동기식 및 비동기식 생성에 모두 동일한 API를 사용하면 애플리케이션 구현이 간소화될 수 있습니다.
• 비동기(기본값) 생성은 비동기적으로 이루어지며, QQmlEngine 에 QQmlIncubatorController가 설정되어 있다고 가정합니다.

  인큐베이터는 생성이 완료되거나 오류가 발생할 때까지 로드 중 상태로 유지됩니다. statusChanged () 콜백을 사용하여 상태 변경에 대한 알림을 받을 수 있습니다.

  애플리케이션은 즉시 필요하지 않은 개체를 만들 때는 비동기 인큐베이션 모드를 사용해야 합니다. 예를 들어 ListView 유형은 비동기 인큐베이션을 사용하여 목록이 스크롤되는 동안 화면에서 약간 벗어난 개체를 만듭니다. 비동기 생성 중에 개체가 즉시 필요한 경우 QQmlIncubator::forceCompletion() 메서드를 호출하여 생성 프로세스를 동기적으로 완료할 수 있습니다.

• AsynchronousIfNested 생성은 중첩된 비동기 생성의 일부인 경우 비동기적으로, 그렇지 않은 경우 동기적으로 수행됩니다.

  QML 컴포넌트가 동기 인스턴스화처럼 보이기를 원하는 대부분의 시나리오에서는 이 모드를 사용해야 합니다.

  이 모드는 예시를 통해 가장 잘 설명됩니다. ListView 유형이 처음 생성되면 표시할 초기 델리게이트 집합으로 자체적으로 채워야 합니다. ListView 의 높이가 400픽셀이고 각 델리게이트의 높이가 100픽셀인 경우 초기 델리게이트 인스턴스 4개를 만들어야 합니다. ListView 에서 비동기 인큐베이션 모드를 사용하는 경우 ListView 은 항상 비어 있다가 나중에 4개의 초기 항목이 나타납니다.

  반대로 ListView 이 동기식 인큐베이션 모드를 사용하면 올바르게 작동하지만 애플리케이션에 버벅거림이 발생할 수 있습니다. QML은 ListView 의 델리게이트를 동기적으로 중지하고 인스턴스화해야 하므로 ListView 이 비동기적으로 인스턴스화되는 QML 컴포넌트의 일부인 경우 비동기 인스턴스화의 이점을 대부분 상실하게 됩니다.

  AsynchronousIfNested 모드는 이 문제를 해결합니다. AsynchronousIfNested 을 사용하면 ListView 자체가 이미 비동기 인스턴스화의 일부인 경우 ListView 델리게이트가 비동기적으로 인스턴스화되고 그렇지 않은 경우 동기적으로 인스턴스화됩니다. 중첩된 비동기 인스턴스화의 경우 외부 비동기 인스턴스화는 중첩된 모든 인스턴스화도 완료될 때까지 완료되지 않습니다. 이렇게 하면 외부 비동기 인스턴스화가 완료될 때 ListView 같은 내부 항목은 이미 초기 델리게이트 로드를 완료한 상태입니다.

  동기 인스턴스화의 모양을 원하지만 애플리케이션이 멈추거나 끊기는 단점이 없는 요소나 컴포넌트는 AsynchronousIfNested 인큐베이션 모드를 사용해야 합니다.