이 페이지에서

QtAndroidPrivate Namespace

QtAndroidPrivate 네임스페이스는 Android 개발을 지원하는 다양한 함수를 제공합니다. 더 보기...

헤더: #include <QtCore/private/qandroidextras_p.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS CorePrivate)
target_link_libraries(mytarget PRIVATE Qt6::CorePrivate)
qmake: QT += core-private
다음부터: Qt 6.2부터
상태: 기술 미리보기

이 네임스페이스는 기술 미리보기 단계에 있으며 변경될 수 있습니다.

유형

(since 6.2) enum class BindFlag { None, AutoCreate, DebugUnbind, NotForeground, AboveClient, …, ExternalService }
flags BindFlags

함수

(since 6.2) bool bindService(const QAndroidIntent &serviceIntent, const QAndroidServiceConnection &serviceConnection, QtAndroidPrivate::BindFlags flags = BindFlag::None)
(technology preview) QFuture<QtAndroidPrivate::PermissionResult> checkPermission(const QString &permission)
(technology preview) QFuture<QtAndroidPrivate::PermissionResult> requestPermission(const QString &permission)
(since 6.2) void startActivity(const QAndroidIntent &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
(since 6.2) void startActivity(const QJniObject &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)
(since 6.2) void startActivity(const QJniObject &intent, int receiverRequestCode, std::function<void (int, int, const QJniObject &)> callbackFunc)
(since 6.2) void startIntentSender(const QJniObject &intentSender, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)

상세 설명

유형 설명서

[since 6.2] enum class QtAndroidPrivate::BindFlag
flags QtAndroidPrivate::BindFlags

이 열거형은 ` QtAndroidPrivate::bindService `와 함께 사용되어 바인딩이 수행되는 모드를 설명합니다.

상수값설명
QtAndroidPrivate::BindFlag::None0x00000000옵션 없음.
QtAndroidPrivate::BindFlag::AutoCreate0x00000001바인딩이 존재하는 한 서비스를 자동으로 생성합니다. 자세한 내용은 BIND_AUTO_CREATE 문서를 참조하십시오.
QtAndroidPrivate::BindFlag::DebugUnbind0x00000002unbind 호출이 일치하지 않을 경우 디버깅 도움말을 포함합니다. 자세한 내용은 BIND_DEBUG_UNBIND 문서를 참조하십시오.
QtAndroidPrivate::BindFlag::NotForeground0x00000004이 바인딩이 대상 서비스의 프로세스를 포그라운드 스케줄링 우선순위로 올리는 것을 허용하지 않습니다. 자세한 내용은 BIND_NOT_FOREGROUND 문서를 참조하십시오.
QtAndroidPrivate::BindFlag::AboveClient0x00000008이 서비스에 바인딩된 클라이언트 애플리케이션이 해당 서비스를 애플리케이션 자체보다 더 중요하게 간주함을 나타냅니다. 자세한 내용은 BIND_ABOVE_CLIENT 문서를 참조하십시오.
QtAndroidPrivate::BindFlag::AllowOomManagement0x00000010바인딩된 서비스를 호스팅하는 프로세스가 정상적인 메모리 관리 절차를 거치도록 허용합니다. 자세한 내용은 BIND_ALLOW_OOM_MANAGEMENT 문서를 참조하십시오.
QtAndroidPrivate::BindFlag::WaivePriority0x00000020대상 서비스를 호스팅하는 프로세스의 스케줄링 또는 메모리 관리 우선순위에 영향을 미치지 않습니다. 자세한 내용은 BIND_WAIVE_PRIORITY 문서를 참조하십시오.
QtAndroidPrivate::BindFlag::Important0x00000040이 서비스에는 필요할 때 클라이언트가 사용할 수 있도록 더 높은 우선순위가 할당됩니다. 자세한 내용은 BIND_IMPORTANT 문서를 참조하십시오.
QtAndroidPrivate::BindFlag::AdjustWithActivity0x00000080액티비티에서 바인딩하는 경우, 해당 액티비티가 사용자에게 표시되는지 여부에 따라 대상 서비스 프로세스의 중요도를 높일 수 있도록 허용합니다. 자세한 내용은 BIND_ADJUST_WITH_ACTIVITY 문서를 참조하십시오.
QtAndroidPrivate::BindFlag::ExternalService-2147483648바인딩되는 서비스는 격리된 외부 서비스입니다. 자세한 내용은 BIND_EXTERNAL_SERVICE 문서를 참조하십시오.

이 열거형은 Qt 6.2에서 도입되었습니다.

BindFlags 유형은 QFlags<BindFlag>에 대한 typedef입니다. 이 유형은 BindFlag 값들의 OR 조합을 저장합니다.

함수 문서

[since 6.2] bool QtAndroidPrivate::bindService(const QAndroidIntent &serviceIntent, const QAndroidServiceConnection &serviceConnection, QtAndroidPrivate::BindFlags flags = BindFlag::None)

serviceIntent, serviceConnection 및 flags 에서 제공하는 서비스를 바인딩합니다. serviceIntent 객체는 연결할 서비스를 식별합니다. serviceConnection 는 서비스가 시작되거나 중지될 때 해당 정보를 수신하는 리스너입니다.

성공 시 true를 반환합니다

자세한 내용은 Android 문서를 참조하십시오.

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

QAndroidIntent, QAndroidServiceConnection 및 BindFlag도 참조하십시오 .

[technology preview] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::checkPermission(const QString &permission)

이 기능은 기술 미리보기 단계에 있으며, 변경될 수 있습니다.

이 프로세스가 지정된 permission 를 가지고 있는지 확인하고, 확인 결과를 나타내는 QFuture 를 반환합니다.

참고: QPermission 은 권한을 요청할 때 사용하도록 권장되는 API입니다. QPermission 가 요청하려는 Android 권한을 지원하지 않는 경우에도 이 예비 API를 대신 사용할 수 있습니다.

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

requestPermission()도 참조하십시오 .

[technology preview] QFuture<QtAndroidPrivate::PermissionResult> QtAndroidPrivate::requestPermission(const QString &permission)

이 기능은 기술 미리보기 단계에 있으며, 변경될 수 있습니다.

permission 를 요청하고, 요청 결과를 나타내는 QFuture 를 반환합니다.

참고: QPermission 는 권한을 요청할 때 사용을 권장하는 API입니다. QPermission 가 요청하려는 Android 권한을 지원하지 않는 경우, 대신 이 예비 API를 계속 사용할 수 있습니다.

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

checkPermission()도 참조하십시오 .

[since 6.2] void QtAndroidPrivate::startActivity(const QAndroidIntent &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)

intent 로 지정된 액티비티를 시작하고, resultReceiver 가 null이 아닌 경우 이를 통해 결과를 비동기적으로 제공합니다.

resultReceiver 가 null인 경우, QNativeInterface::QAndroidApplication::context()의 startActivity() 메서드가 호출됩니다. 그렇지 않은 경우 startActivityForResult() 가 호출됩니다.

receiverRequestCode 는 resultReceiver 에 고유한 요청 코드이며, 결과와 함께 반환되므로 하나의 리시버를 여러 인텐트에 사용할 수 있습니다.

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

[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)

intent 로 지정된 액티비티를 시작하고, resultReceiver 가 null이 아닌 경우 해당 메서드를 통해 결과를 비동기적으로 제공합니다.

resultReceiver 가 null인 경우, QNativeInterface::QAndroidApplication::context()의 startActivity() 메서드가 호출됩니다. 그렇지 않은 경우 startActivityForResult() 가 호출됩니다.

receiverRequestCode 는 resultReceiver 에 고유한 요청 코드이며, 결과와 함께 반환되므로 하나의 리시버를 여러 인텐트에 사용할 수 있습니다.

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

[since 6.2] void QtAndroidPrivate::startActivity(const QJniObject &intent, int receiverRequestCode, std::function<void (int, int, const QJniObject &)> callbackFunc)

intent 로 지정된 액티비티를 요청 코드 receiverRequestCode 를 사용하여 시작하고, callbackFunc 를 호출하여 결과를 반환합니다.

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

[since 6.2] void QtAndroidPrivate::startIntentSender(const QJniObject &intentSender, int receiverRequestCode, QAndroidActivityResultReceiver *resultReceiver = nullptr)

intentSender 로 지정된 액티비티를 시작하고, resultReceiver 가 null이 아닌 경우 이를 통해 결과를 비동기적으로 제공합니다.

resultReceiver 가 null인 경우, QNativeInterface::QAndroidApplication::context()의 startIntentSender() 메서드가 호출됩니다. 그렇지 않은 경우 startIntentSenderForResult() 가 호출됩니다.

receiverRequestCode 는 resultReceiver 에 고유한 요청 코드이며, 결과와 함께 반환되므로 하나의 리시버를 여러 인텐트에 사용할 수 있습니다.

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

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