स्मार्ट होम वॉल्यूम ट्राम स्कीमा
action.devices.traits.Volume
- यह खासियत उन डिवाइस से जुड़ी है जो आवाज़ को कम या ज़्यादा कर सकते हैं. उदाहरण के लिए, आवाज़ को किसी खास लेवल, म्यूट या अनम्यूट करने के लिए सेट करना.
डिवाइस की विशेषताएं
जिन डिवाइसों में यह एट्रिब्यूट मौजूद है वे 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 }
डिवाइस के राज्य
इस खासियत वाली इकाइयां, QUERY
ऑपरेशन के हिस्से के तौर पर
इन स्थितियों की रिपोर्ट कर सकती हैं. QUERY
इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
राज्य | टाइप | जानकारी |
---|---|---|
currentVolume |
Integer |
ज़रूरी है. आवाज़ का मौजूदा प्रतिशत. यह |
isMuted |
बूलियन |
अगर |
उदाहरण
स्पीकर डिवाइस, जिसे म्यूट किया जा सकता है और मौजूदा स्थिति की रिपोर्ट कर सकता है
{ "currentVolume": 5, "isMuted": false }
डिवाइस के निर्देश
जिन डिवाइसों पर इस एट्रिब्यूट का इस्तेमाल होता है वे 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 } }
डिवाइस की गड़बड़ियां
गड़बड़ियों और अपवादों की पूरी सूची देखें.volumeAlreadyMax
: जब डिवाइस की आवाज़ पहले से ही सबसे ज़्यादा हो गई हो, तब उसेVolumeUp
निर्देश मिलता है.volumeAlreadyMin
: डिवाइस की आवाज़ कम से कम होने पर, उसेVolumeDown
निर्देश मिलता है.