स्मार्ट होम वॉल्यूम ट्राम स्कीमा

action.devices.traits.Volume - यह खासियत उन डिवाइस से जुड़ी है जो आवाज़ को कम या ज़्यादा कर सकते हैं. उदाहरण के लिए, आवाज़ को किसी खास लेवल, म्यूट या अनम्यूट करने के लिए सेट करना.

डिवाइस की विशेषताएं

जिन डिवाइसों में यह एट्रिब्यूट मौजूद है वे SYNC कार्रवाई के तहत, इन एट्रिब्यूट की रिपोर्ट कर सकते हैं. SYNC इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

विशेषताएं	टाइप	जानकारी
volumeMaxLevel	Integer	ज़रूरी है. 0 (म्यूटेशन) का बेसलाइन मानकर, ज़्यादा से ज़्यादा वॉल्यूम लेवल. Assistant, ज़रूरत के हिसाब से निर्देश देने की सेटिंग में बदलाव करेगी (उदाहरण के लिए, 'टीवी को थोड़ा तेज़ करो').
volumeCanMuteAndUnmute	बूलियन	ज़रूरी है. इससे पता चलता है कि क्या डिवाइस वॉल्यूम को म्यूट और अनम्यूट कर सकता है. म्यूट एक अलग विकल्प है, क्योंकि 'म्यूट' व्यवहार पिछले वॉल्यूम को याद रखते हुए वॉल्यूम को 0 पर ले जाता है, ताकि अनम्यूट करने पर उसे पहले जैसा कर दिया जाए. यह वॉल्यूम की स्थिति में दिखता है—अगर वॉल्यूम 5 है और उपयोगकर्ता म्यूट करता है, तो वॉल्यूम 5 रहता है और isMuted सही होता है.
volumeDefaultPercentage	Integer	(डिफ़ॉल्ट: 40) उपयोगकर्ता या निर्माता की ओर से तय डिफ़ॉल्ट वॉल्यूम के लिए वॉल्यूम (प्रतिशत में). स्केल 0-100 होना चाहिए.
levelStepSize	Integer	(डिफ़ॉल्ट: 1) रिलेटिव वॉल्यूम से जुड़ी क्वेरी के लिए, डिफ़ॉल्ट चरण का साइज़. जैसे, '<device_name> पर वॉल्यूम अप'.
commandOnlyVolume	बूलियन	(डिफ़ॉल्ट: false) यह बताता है कि डिवाइस एकतरफ़ा (सही) या दोतरफ़ा (गलत) कम्यूनिकेशन का इस्तेमाल करके काम करता है या नहीं. उदाहरण के लिए, अगर अनुरोध भेजने के बाद नियंत्रक नए डिवाइस की स्थिति की पुष्टि कर सकता है, तो यह फ़ील्ड गलत होगी. अगर इस बात की पुष्टि करना मुमकिन नहीं है कि अनुरोध सफलतापूर्वक किया गया है या डिवाइस की स्थिति के बारे में जानना है (उदाहरण के लिए, अगर डिवाइस परंपरागत इन्फ़्रारेड रिमोट है), तो इस फ़ील्ड को 'सही' पर सेट करें.

उदाहरण

स्पीकर डिवाइस, जिसे म्यूट किया जा सकता है और मौजूदा स्थिति की रिपोर्ट कर सकता है

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

डिवाइस के राज्य

इस खासियत वाली इकाइयां, QUERY ऑपरेशन के हिस्से के तौर पर इन स्थितियों की रिपोर्ट कर सकती हैं. QUERY इंटेंट मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.

राज्य	टाइप	जानकारी
currentVolume	Integer	ज़रूरी है. आवाज़ का मौजूदा प्रतिशत. यह >0 और volumeMaxLevel के बीच होना चाहिए.
isMuted	बूलियन	अगर volumeCanMuteAndUnmute एट्रिब्यूट को 'सही है' पर सेट किया गया है, तो ज़रूरी है. अगर डिवाइस को म्यूट किया गया है, तो वैल्यू 'सही' होगी, नहीं तो 'गलत' पर सेट होगी. isMuted के सही होने पर, डिवाइस अब भी याद रखे गए पॉइंट के लिए currentVolume दिखाता है.

उदाहरण

स्पीकर डिवाइस, जिसे म्यूट किया जा सकता है और मौजूदा स्थिति की रिपोर्ट कर सकता है

{
  "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	ज़रूरी है. नया वॉल्यूम, 0 से volumeMaxLevel तक.

उदाहरण

स्पीकर वाले डिवाइस की आवाज़ कम या ज़्यादा करें

{
  "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 निर्देश मिलता है.