WebChannel QML Type

QWebChannel 에 대한 QML 인터페이스. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• blockUpdates : bool
• propertyUpdateInterval : int
• registeredObjects : list<QtObject>
• transports : list<QtObject>

연관 속성

• id : string

방법

• void connectTo(QtObject transport)
• void deregisterObject(QtObject object)
• void disconnectFrom(QtObject transport)
• void registerObject(const string id, QtObject object)
• void registerObjects(object objects)

상세 설명

WebChannel은 HTML 클라이언트에서 QObject 또는 QML 객체에 투명하게 접근할 수 있는 메커니즘을 제공합니다. 모든 속성, 시그널 및 공개 슬롯을 HTML 클라이언트에서 사용할 수 있습니다.

QWebChannel 및 JavaScript API도 참조하십시오 .

속성 문서

blockUpdates : bool

이 속성을 ` true`로 설정하면 업데이트가 차단되며, 원격 클라이언트에는 속성 변경 사항이 알림되지 않습니다.

이 속성을 ` false`로 설정하여 업데이트 차단이 해제되면 변경 사항이 기록되고 클라이언트로 전송됩니다. 기본적으로 업데이트는 차단되지 않습니다.

propertyUpdateInterval : int

속성 업데이트 간격.

이 간격은 양수 값을 설정하여 밀리초 단위의 다른 값으로 변경할 수 있습니다. 속성 업데이트는 일괄 처리되어 해당 간격이 만료된 후 전송됩니다. 0으로 설정하면, 단일 이벤트 루프 실행 내에서 발생한 업데이트가 일괄 처리되어 다음 실행 시 전송됩니다. 음수 값으로 설정하면 업데이트가 즉시 전송됩니다. 기본값은 50밀리초입니다.

registeredObjects : list<QtObject> [read-only]

원격 클라이언트가 액세스할 수 있어야 하는 객체 목록입니다.

객체에는 ' id ' 속성이 지정된 식별자가 연결되어 있어야 하며, 이 식별자를 통해 HTML 측에서 해당 객체를 식별할 수 있습니다.

등록이 완료되면 모든 시그널과 속성 변경 사항이 클라이언트로 자동으로 전달됩니다. 슬롯을 포함한 공개 호출 가능 메서드도 클라이언트에서 접근할 수 있습니다.

컴포넌트 생성 시점에 사용할 수 없는 객체를 등록해야 하는 경우, 명령형 registerObjects 메서드를 사용하십시오.

registerObjects() 및 id도 참조하십시오 .

transports : list<QtObject> [read-only]

QWebChannelAbstractTransport 를 구현하는 전송 객체 목록입니다. 이 전송 객체들은 원격 클라이언트와 통신하는 데 사용됩니다.

connectTo() 및 disconnectFrom()도 참조하십시오 .

첨부 속성 설명서

WebChannel.id : string [attached]

WebChannel에 등록된 객체가 원격 클라이언트에 식별되는 데 사용되는 식별자입니다.

WebChannel을 통해 게시되어야 하는 모든 객체에 대해 이 속성을 설정해야 합니다. id의 형식에 대한 제한은 없지만, 일반적으로 유효한 JavaScript 식별자이기도 한 문자열을 선택하는 것이 좋습니다.

메서드 설명서

void connectTo(QtObject transport)

transport 에 연결되며, 이는 단일 클라이언트와의 통신 채널을 나타냅니다.

이 전송 객체는 QWebChannelAbstractTransport 의 구현체여야 합니다.

transports 및 disconnectFrom()도 참조하십시오 .

void deregisterObject(QtObject object)

지정된 object 을 WebChannel에서 등록 해제합니다.

원격 클라이언트는 지정된 객체에 대한 destroyed 신호를 수신하게 됩니다.

registerObjects(), registerObject(), registeredObjects도 참조하십시오 .

void disconnectFrom(QtObject transport)

transport 를 이 WebChannel에서 분리합니다.

클라이언트는 더 이상 WebChannel과 통신할 수 없으며, 신호나 속성 업데이트도 수신할 수 없게 됩니다.

connectTo()도 참조하십시오 .

void registerObject(const string id, QtObject object)

WebChannel에 단일 객체를 등록합니다.

object 의 속성, 신호 및 공개 메서드는 원격 클라이언트에 공개됩니다. 그러면 해당 클라이언트 측에서 식별자가 id 인 객체가 생성됩니다.

BINDABLE 에 속하지만 NOTIFY 신호를 갖지 않는 속성의 경우, 클라이언트 측에서 속성 업데이트는 정상적으로 이루어지지만, 변경 알림에 대한 콜백을 등록할 수 있는 메커니즘은 제공되지 않습니다.

registerObjects(), deregisterObject() 및 registeredObjects도 참조하십시오 .

void registerObjects(object objects)

지정된 ` objects `를 등록하여 HTML 클라이언트가 이에 접근할 수 있도록 합니다. ` objects `는 JavaScript Map 객체여야 합니다. 이 맵의 키는 클라이언트 측에서 객체를 식별하는 데 사용됩니다.

일단 등록되면 모든 신호와 속성 변경 사항이 클라이언트로 자동 전달됩니다. 슬롯을 포함한 공개 호출 가능 메서드도 클라이언트에서 접근할 수 있습니다.

이 명령형 API는 객체를 즉석에서 등록하는 데 사용할 수 있습니다. 정적 객체의 경우, 선언형 registeredObjects 속성을 우선적으로 사용해야 합니다.

registeredObjects도 참조하십시오 .