이 페이지에서

QRemoteObjectHost Class

Qt Remote Objects 네트워크상의 A(호스트) 노드. 더 보기...

헤더: #include <QRemoteObjectHost>
CMake: find_package(Qt6 REQUIRED COMPONENTS RemoteObjects)
target_link_libraries(mytarget PRIVATE Qt6::RemoteObjects)
qmake: QT += remoteobjects
QML에서: Host
상속: QRemoteObjectHostBase

속성

공개 함수

QRemoteObjectHost(QObject *parent = nullptr)
QRemoteObjectHost(const QUrl &address, QObject *parent)
QRemoteObjectHost(const QUrl &address, const QUrl &registryAddress = QUrl(), QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly, QObject *parent = nullptr)

재구현된 공용 함수

virtual QUrl hostUrl() const override
virtual bool setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly) override

신호

정적 공용 멤버

(since 6.7) void setLocalServerOptions(QLocalServer::SocketOptions options)

상세 설명

QRemoteObjectHost 클래스는 QRemoteObject QtRemoteObjects 네트워크에 대한 진입점을 제공합니다. 네트워크는 두 개의 노드로 구성된 간단한 형태일 수도 있고, 프로세스와 장치로 이루어진 임의로 복잡한 집합일 수도 있습니다.

QRemoteObjectHost는 QRemoteObjectNode와 동일한 기능을 가지지만, 네트워크에 연결되어 소스 객체를 공유할 수도 있습니다.

노드는 ` connectToNode`를 사용하여 서로 직접 연결하거나, ` QRemoteObjectRegistry `를 사용하여 연결을 단순화할 수 있습니다.

QRemoteObjectRegistry 는 레지스트리 URL에 연결된 모든 노드가 사용할 수 있는 특수한 복제본입니다. 이 객체는 네트워크상의 모든 QRemoteObjectSource 객체에 연결하는 방법을 알고 있습니다.

QRemoteObjectNode 및 QRemoteObjectRegistryHost도 참조하십시오 .

속성 설명서

hostUrl : QUrl

이 속성은 노드의 호스트 주소를 저장합니다.

이 주소는 이 노드를 통해 원격으로 전송된 소스 객체가 상주하게 될 주소입니다.

액세스 함수:

virtual QUrl hostUrl() const override
virtual bool setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly) override

알림 신호:

void hostUrlChanged()

멤버 함수 문서

QRemoteObjectHost::QRemoteObjectHost(QObject *parent = nullptr)

주어진 parent 를 사용하여 새로운 QRemoteObjectHost 노드(즉, QtRO 네트워크에서 소스 객체를 노출하는 기능을 지원하는 노드)를 생성합니다. 이 생성자는 setHostUrl 가 호출될 때까지 연결할 수 없으므로, 향후 QML을 지원하기 위해 특별히 마련된 것입니다.

setHostUrl() 및 setRegistryUrl()도 참조하십시오 .

QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, QObject *parent)

URL이 address 이고, 지정된 parent 를 갖는 새로운 QRemoteObjectHost 노드(즉, QtRO 네트워크에서 Source 객체를 노출하는 것을 지원하는 노드)를 생성합니다. 이 오버로드는 레지스트리 주소를 지정하지 않고도 QObject 상위 노드를 지정할 수 있도록 편의를 위해 제공됩니다.

setHostUrl() 및 setRegistryUrl()도 참조하십시오 .

QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, const QUrl &registryAddress = QUrl(), QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly, QObject *parent = nullptr)

주소 address 을 가진 새로운 QRemoteObjectHost 노드(즉, QtRO 네트워크에서 Source 객체를 노출하는 것을 지원하는 노드)를 생성합니다. 설정된 경우, registryAddress 가 제공된 주소의 QRemoteObjectRegistry 에 연결하는 데 사용됩니다. allowedSchemas 매개변수는 URL의 스키마를 레지스트리에서 외부 스키마(External Schema )로 사용해야 하는 경우에만 필요하며(이 경우 AllowExternalRegistration 로 설정해야 함),

setHostUrl() 및 setRegistryUrl()도 참조하십시오 .

[override virtual] QUrl QRemoteObjectHost::hostUrl() const

QRemoteObjectNode 의 호스트 주소를 QUrl 형식으로 반환합니다. Node가 Host 노드가 아닌 경우, 빈 QUrl 을 반환합니다.

참고: hostUrl 속성에 대한게터 함수입니다.

참조: setHostUrl().

[override virtual] bool QRemoteObjectHost::setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly)

호스트 QRemoteObjectNode 의 hostAddress 를 설정합니다.

호스트 주소가 설정되어 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

allowedSchemas 매개변수는 URL의 스키마가 레지스트리에서 외부 스키마(External Schema )로 사용되어야 하는 경우에만 필요하며(이 경우 AllowExternalRegistration 로 설정해야 함),

참고: hostUrl 속성에 대한설정 함수입니다.

hostUrl()도 참조하십시오 .

[static, since 6.7] void QRemoteObjectHost::setLocalServerOptions(QLocalServer::SocketOptions options)

QLocalServer 백엔드의 소켓 옵션을 options 로 설정합니다.

이 설정은 QRemoteObjectHost 객체가 수신 대기 상태를 시작하기 전에 설정되어야 합니다. 이미 수신 대기 중인 QRemoteObjectHost 객체나 QLocalServer 이외의 백엔드를 사용하는 QRemoteObjectHost 객체에는 아무런 영향을 미치지 않습니다. QRemoteObjectHost 객체는 address 인수가 비어 있지 않은 경우 생성 시 수신 대기 상태를 시작하며, 그렇지 않은 경우 setHostUrl()를 통해 주소가 설정될 때 수신 대기 상태를 시작합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

setHostUrl() 및 QRemoteObjectHost()도 참조하십시오 .

© 2026 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.