पहनने की पहचान का परिचय

Wear Detection डिवाइस की capability, enabled state और current left/right wear state देता है। Configurable capability वाले devices SDK से detection enable या disable भी कर सकते हैं।

उपलब्ध सुविधाएँ

📄️पहनने की पहचान की क्षमता देखें

डिवाइस द्वारा बताई गई पहनने की पहचान की क्षमता पढ़ें

📄️पहनने की पहचान की स्थिति देखें

डिवाइस द्वारा बताई गई enabled स्थिति और वर्तमान पहनने की स्थिति पढ़ें

📄️पहनने की पहचान सेट करें

configurable डिवाइस पर पहनने की पहचान enable या disable करें

AI की सहायता से लागू करें

AI से बनाएँ

इस वर्कफ़्लो को AI से लागू करें

आधिकारिक “AIBuds पहनने की पहचान प्रबंधित करें” स्किल से वर्कफ़्लो को अपने ऐप के अनुसार लागू करें।

https://docs-aibuds.github.io/hi/skills/manage-aibuds-wear-detection को पढ़ें और निर्देशों का पालन करें। इस स्किल से “AIBuds पहनने की पहचान प्रबंधित करें” को इस iOS प्रोजेक्ट में लागू करें और परिणाम सत्यापित करें।

आधिकारिक स्किल देखें↗

शुरुआत करें

1. डिवाइस कनेक्ट करें - डिवाइस के connected और ready होने की प्रतीक्षा करें।
2. Protocol conformance जाँचें - DeviceWearDetectionAPI support की पुष्टि करें।
3. Capability पढ़ें - Detection supported और configurable है या नहीं जानने के लिए wearDetectionCapability उपयोग करें।
4. Current state पढ़ें - isWearDetectionEnabled और wearStatus उपयोग करें।
5. Support होने पर configure करें - setWearDetection(enabled:completion:) केवल configurable device पर call करें।

मुख्य अवधारणाएँ

क्षमता

WearDetectionCapability तीन levels अलग करता है:

Value	अर्थ
.none	Wear detection supported नहीं।
.supportedNotConfigurable	Wear detection supported है, लेकिन इस API से enabled state नहीं बदल सकती।
.supportedAndConfigurable	Wear detection supported है और enable या disable की जा सकती है।

स्थिति

• isWearDetectionEnabled बताता है कि detection अभी enabled है या नहीं।
• WearStatus unknown, not wearing, left-only, right-only या both-ear state report करता है।
• Capability, enabled state और wear state अलग values हैं; एक से दूसरे का अनुमान न लगाएँ।

प्रोटोकॉल संदर्भ

Wear Detection DeviceWearDetectionAPI से मिलता है:

Swift

Swift

guard let device = device as? DeviceWearDetectionAPI else {
    print("Device does not support DeviceWearDetectionAPI")
    return
}

Objective-C

Objective-C

id<AIBudsDeviceWearDetectionAPI> device = (id<AIBudsDeviceWearDetectionAPI>)self.device;
if (![device conformsToProtocol:@protocol(AIBudsDeviceWearDetectionAPI)]) {
    NSLog(@"Device does not support AIBudsDeviceWearDetectionAPI");
    return;
}

सर्वोत्तम अभ्यास

1. Configuration से पहले capability जाँचें: केवल .supportedAndConfigurable enabled state बदलने की अनुमति देता है।
2. Current properties उपयोग करें: काल्पनिक query methods call करने के बजाय SDK के current snapshots पढ़ें।
3. Changes देखें: Enabled-state और wear-state changes के लिए DeviceDelegate callbacks उपयोग करें।
4. Unknown को स्पष्ट रूप से संभालें: .unknown को .notWearing से अलग रखें।

ध्यान दें

• SDK में enum case होना यह guarantee नहीं करता कि हर device उस capability को support करता है।
• Wear state बदलने पर SDK automatic playback behavior की guarantee नहीं देता; app behavior product requirements पर आधारित होना चाहिए।
• SDK Demo DeviceWearDetectionAPI से capability और enabled state पढ़ता है और capability configurable होने पर ही configuration दिखाता है।