WebChannel QML Type

QML 인터페이스 QWebChannel. 더 보기...

Import Statement: import QtWebChannel 1.8

속성

첨부 속성

  • id : string

방법

상세 설명

웹채널은 HTML 클라이언트에서 QObject 또는 QML 개체에 투명하게 액세스할 수 있는 메커니즘을 제공합니다. 모든 속성, 신호 및 공개 슬롯은 HTML 클라이언트에서 사용할 수 있습니다.

QWebChannelJavaScript 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

웹채널에 등록된 객체가 원격 클라이언트에 알려지는 식별자입니다.

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


메서드 문서

void connectTo(QtObject transport)

단일 클라이언트에 대한 통신 채널을 나타내는 transport 에 연결합니다.

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

transportsdisconnectFrom()도 참조하세요 .


void deregisterObject(QtObject object)

주어진 object 을 웹채널에서 등록 취소합니다.

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

registerObjects(), registerObject() 및 registeredObjects도 참조하세요 .


void disconnectFrom(QtObject transport)

이 웹채널에서 transport 의 연결을 끊습니다.

클라이언트는 더 이상 웹채널과 통신할 수 없으며 신호나 속성 업데이트도 받지 못합니다.

connectTo()도 참조하세요 .


void registerObject(const string id, QtObject object)

단일 객체를 웹채널에 등록합니다.

object 의 속성, 시그널 및 공용 메서드가 원격 클라이언트에 게시됩니다. 그러면 식별자가 id 인 객체가 구성됩니다.

BINDABLE 이지만 NOTIFY 신호가 없는 프로퍼티는 클라이언트 측에서 프로퍼티 업데이트가 작동하지만 변경 알림에 대한 콜백을 등록하는 메커니즘은 없습니다.

참고: 현재 제한 사항은 클라이언트가 초기화되기 전에 객체를 등록해야 한다는 것입니다.

registerObjects(), deregisterObject() 및 registeredObjects참조하세요 .


void registerObjects(object objects)

지정된 objects 을 등록하여 HTML 클라이언트에서 액세스할 수 있도록 합니다. objects 은 JavaScript 맵 객체여야 합니다. 맵의 키는 클라이언트 측에서 객체의 식별자로 사용됩니다.

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

이 명령형 API는 오브젝트를 즉시 등록하는 데 사용할 수 있습니다. 정적 객체의 경우 선언적 registeredObjects 프로퍼티를 사용하는 것이 좋습니다.

registeredObjects도 참조하세요 .


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.