स्मार्ट होम वॉल्यूम ट्रैट स्कीमा
action.devices.traits.Volume
- यह trait उन डिवाइसों का है जो आवाज़ में बदलाव कर सकते हैं. उदाहरण के लिए, आवाज़ को किसी खास लेवल पर सेट करना, म्यूट या अनम्यूट करना.
डिवाइस ATTRIBUTES
इस एट्रिब्यूट वाले डिवाइस, SYNC
ऑपरेशन के तहत, यहां दिए गए
एट्रिब्यूट रिपोर्ट कर सकते हैं. SYNC
इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
विशेषताएं | टाइप | ब्यौरा |
---|---|---|
volumeMaxLevel |
Integer |
ज़रूरी है. बेसलाइन के लिए 0 (म्यूट) मानते हुए, आवाज़ का सबसे ज़्यादा लेवल. Assistant, क्रियाविशेषणों के निर्देशों (जैसे, 'टीवी की आवाज़ बढ़ाओ') में ज़रूरत के हिसाब से बदलाव करेगी. |
volumeCanMuteAndUnmute |
बूलियन |
ज़रूरी है. इससे पता चलता है कि डिवाइस आवाज़ को म्यूट और अनम्यूट कर सकता है या नहीं. म्यूट करना एक अलग विकल्प है, क्योंकि 'म्यूट करें' कार्रवाई करने पर पिछली आवाज़ को याद रखते हुए आवाज़ को 0 पर सेट कर दिया जाता है, ताकि अनम्यूट करने पर आवाज़ पहले जैसी हो जाए. यह वॉल्यूम की स्थिति में दिखता है. अगर वॉल्यूम 5 है और उपयोगकर्ता म्यूट कर देता है, तो वॉल्यूम 5 रहता है और |
volumeDefaultPercentage |
Integer |
(डिफ़ॉल्ट: उपयोगकर्ता या मैन्युफ़ैक्चरर की तय की गई डिफ़ॉल्ट वॉल्यूम का वॉल्यूम (प्रतिशत में). स्केल 0 से 100 के बीच होना चाहिए. |
levelStepSize |
Integer |
(डिफ़ॉल्ट: रिलेटिव वॉल्यूम क्वेरी के लिए डिफ़ॉल्ट चरण साइज़, जैसे कि '<device_name> पर आवाज़ तेज़ करें'. |
commandOnlyVolume |
बूलियन |
(डिफ़ॉल्ट: यह बताता है कि डिवाइस एकतरफ़ा (सही) या दोतरफ़ा (गलत) कम्यूनिकेशन का इस्तेमाल करके काम करता है. उदाहरण के लिए, अगर अनुरोध भेजने के बाद कंट्रोलर, डिवाइस की नई स्थिति की पुष्टि कर सकता है, तो यह फ़ील्ड गलत होगा. अगर इस बात की पुष्टि न हो पाए कि अनुरोध लागू हुआ है या नहीं या डिवाइस की स्थिति का पता नहीं लगाया जा सकता (उदाहरण के लिए, अगर डिवाइस पारंपरिक इन्फ़्रारेड रिमोट है), तो इस फ़ील्ड को 'सही' पर सेट करें. |
उदाहरण
स्पीकर डिवाइस, जिसे म्यूट किया जा सकता है और मौजूदा स्थिति की रिपोर्ट देता है
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
डिवाइस की स्थितियां
इस trait वाली इकाइयां QUERY
ऑपरेशन के हिस्से के तौर पर,
यहां दिए गए स्टेटस की जानकारी दे सकती हैं. QUERY
इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
राज्य | टाइप | ब्यौरा |
---|---|---|
currentVolume |
Integer |
ज़रूरी है. आवाज़ का मौजूदा प्रतिशत. यह |
isMuted |
बूलियन |
अगर |
उदाहरण
स्पीकर डिवाइस, जिसे म्यूट किया जा सकता है और मौजूदा स्थिति की रिपोर्ट देता है
{ "currentVolume": 5, "isMuted": false }
डिवाइस COMMANDS
इस खूबी वाले डिवाइस, EXECUTE
कार्रवाई के तहत, नीचे दिए गए
निर्देशों का जवाब दे सकते हैं. EXECUTE
इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
action.devices.commands.mute
डिवाइस को म्यूट या अनम्यूट कर देता है.
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
mute |
बूलियन |
ज़रूरी है. किसी डिवाइस को म्यूट करना है या डिवाइस को अनम्यूट करना है. |
उदाहरण
स्पीकर डिवाइस को म्यूट करना
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
volumeMaxLevel
के आधार पर, वॉल्यूम को अनुरोध किए गए लेवल पर सेट करें.
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
volumeLevel |
Integer |
ज़रूरी है. नया वॉल्यूम, |
उदाहरण
स्पीकर डिवाइस का कुल वॉल्यूम सेट करना
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
volumeMaxLevel
के हिसाब से, आवाज़ कम या ज़्यादा करने के n चरण सेट करें. मिलते-जुलते स्केल का इस्तेमाल करने वाले निर्देशों के लिए, Assistant सही तरीके से n को चुनेगी, ताकि वह दिए गए निर्देशों के हिसाब से काम करे. उदाहरण के लिए, टीवी की आवाज़ तेज़ करें इससे टीवी की आवाज़ थोड़ी तेज़ हो जाएगी.
पैरामीटर
पैरामीटर | टाइप | ब्यौरा |
---|---|---|
relativeSteps |
Integer |
ज़रूरी है. 'घटना' के लिए नकारात्मक. |
उदाहरण
सिर्फ़ कमांड मोड में, स्पीकर डिवाइस की आवाज़ के मुकाबले स्पीकर की आवाज़ सेट करना
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
डिवाइस ERRORS
गड़बड़ियों और अपवादों की पूरी सूची देखें.volumeAlreadyMax
: डिवाइस परVolumeUp
निर्देश तब मिलता है, जब इसकी आवाज़ सबसे ज़्यादा होती है.volumeAlreadyMin
: डिवाइस की आवाज़ तब सबसे कम होने पर, उसेVolumeDown
निर्देश मिलता है.