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 특성(characteristic)은 알림(notification) 및/또는 표시(indication)를 지원할 수 있습니다. 두 경우 모두, 주변기기는 특성의 값이 변경될 때마다 중앙기기에 이를 알립니다. 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 Low Energy 장치와의 연결이 끊어져 연결된 서비스가 더 이상 유효하지 않은 경우입니다. 객체가 일단 유효하지 않게 되면 다시 유효해질 수 없습니다.

QString QLowEnergyCharacteristic::name() const

특성의 사람이 읽기 쉬운 이름을 반환합니다.

이 이름은 특성( uuid)을 기반으로 하며, 해당 특성은 표준화되어 있어야 합니다. 특성 유형의 전체 목록은 Bluetooth.org의 '특성(Characteristics)' 섹션에서 확인할 수 있습니다.

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 작업이 성공적으로 수행되었을 때, 또는 업데이트 알림을 수신했을 때 업데이트됩니다.

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

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

other 의 복사본을 생성하여 이 QLowEnergyCharacteristic 객체에 할당합니다. 두 복사본은 계속해서 동일한 서비스 및 컨트롤러 세부 정보를 공유합니다.