QLowEnergyCharacteristic Class

멤버 함수 문서

QLowEnergyCharacteristic::QLowEnergyCharacteristic()

새로운 QLowEnergyCharacteristic을 생성합니다. 이 클래스의 기본 구성 인스턴스는 항상 유효하지 않습니다.

isValid()도 참조하십시오 .

QLowEnergyCharacteristic::QLowEnergyCharacteristic(const QLowEnergyCharacteristic &other)

other 의 복사본인 새로운 QLowEnergyCharacteristic 을 생성합니다.

두 복사본은 쓰기 시 분리되지 않는 동일한 기본 데이터를 계속 공유합니다.

[noexcept] QLowEnergyCharacteristic::~QLowEnergyCharacteristic()

QLowEnergyCharacteristic 객체를 삭제합니다.

[since 6.2] QLowEnergyDescriptor QLowEnergyCharacteristic::clientCharacteristicConfiguration() const

클라이언트 특성 구성 설명자 또는 클라이언트 특성 구성 설명자가 존재하지 않는 경우 잘못된 QLowEnergyDescriptor 인스턴스를 반환합니다.

BTLE 특성은 알림 및/또는 표시를 지원할 수 있습니다. 두 경우 모두, 주변 장치는 특성 값이 변경될 때마다 중앙 장치에 알립니다. BTLE 특성 프로토콜에서 알림 메시지는 중앙에서 확인하지 않는 반면, 표시 메시지는 확인합니다. 알림은 더 빠르지만 신뢰할 수 없는 반면, 표시는 더 느리고 신뢰할 수 있는 것으로 간주됩니다.

특성이 알림 또는 표시를 지원하는 경우 클라이언트 특성 구성 설명자에 특수 비트 패턴을 작성하여 이를 활성화할 수 있습니다. 편의를 위해 이러한 비트 패턴은 QLowEnergyCharacteristic::CCCDDisable, QLowEnergyCharacteristic::CCCDEnableNotification, QLowEnergyCharacteristic::CCCDEnableIndication 로 제공됩니다.

예를 들어 myservice 이라는 서비스에서 mycharacteristic 이라는 특성에 대한 알림을 활성화하려면 다음 코드를 사용하면 됩니다.

auto cccd = mycharacteristic.clientCharacteristicConfiguration();
if (!cccd.isValid()) {
    // your error handling
    return error;
}
myservice->writeDescriptor(cccd, QLowEnergyCharacteristic::CCCDEnableNotification);

이 기능은 Qt 6.2에 도입되었습니다.

descriptor()도 참조하세요 .

QLowEnergyDescriptor QLowEnergyCharacteristic::descriptor(const QBluetoothUuid &uuid) const

uuid 또는 잘못된 QLowEnergyDescriptor 인스턴스에 대한 설명자를 반환합니다.

descriptors()도 참조하세요 .

QList<QLowEnergyDescriptor> QLowEnergyCharacteristic::descriptors() const

이 특성에 속하는 디스크립터 목록을 반환하고, 그렇지 않으면 빈 목록을 반환합니다.

descriptor()도 참조하세요 .

bool QLowEnergyCharacteristic::isValid() const

QLowEnergyCharacteristic 객체가 유효하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

유효하지 않은 특성 객체가 서비스에 연결되어 있지 않거나(기본 구성됨) 기본 Bluetooth 저에너지 장치와의 연결이 끊어지는 등의 이유로 연결된 서비스가 더 이상 유효하지 않은 경우입니다. 개체가 유효하지 않게 되면 더 이상 유효하게 될 수 없습니다.

QString QLowEnergyCharacteristic::name() const

사람이 읽을 수 있는 특성 이름을 반환합니다.

이름은 표준화된 특성 uuid()을 기반으로 합니다. 특성 유형의 전체 목록은 Bluetooth.org 특성에서 확인할 수 있습니다.

uuid()를 알 수 없는 경우 반환되는 문자열은 비어 있습니다.

QBluetoothUuid::characteristicToString()도 참조하세요 .

QLowEnergyCharacteristic::PropertyTypes QLowEnergyCharacteristic::properties() const

특성의 속성을 반환합니다.

속성은 특성에 대한 액세스 권한을 정의합니다.

QBluetoothUuid QLowEnergyCharacteristic::uuid() const

isValid()가 true 을 반환하면 특성의 UUID를 반환하고, 그렇지 않으면 null UUID를 반환합니다.

QByteArray QLowEnergyCharacteristic::value() const

특성의 캐시된 값을 반환합니다.

특성의 properties()가 새 값 쓰기를 허용하는 경우 QLowEnergyService::writeCharacteristic()를 사용하여 값을 업데이트할 수 있습니다.

캐시는 연결된 서비스의 detail discovery, read/write 작업이 성공하거나 업데이트 알림이 수신될 때 업데이트됩니다.

반환된 QByteArray 은 특성에 read permission 이 없는 경우 항상 비어 있습니다. 이러한 경우 QLowEnergyService::characteristicChanged() 또는 QLowEnergyService::characteristicWritten()만이 이 특성 값에 대한 정보를 제공할 수 있습니다.

QLowEnergyCharacteristic &QLowEnergyCharacteristic::operator=(const QLowEnergyCharacteristic &other)

other 복사본을 만들어 이 QLowEnergyCharacteristic 개체에 할당합니다. 두 복사본은 계속해서 동일한 서비스 및 컨트롤러 세부 정보를 공유합니다.