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

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 एट्रिब्यूट को 'सही' पर सेट किया जाता है, तो यह एट्रिब्यूट देना ज़रूरी है. अगर डिवाइस म्यूट है, तो True. अगर डिवाइस म्यूट नहीं है, तो False. अगर 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 निर्देश तब मिलता है, जब उसकी आवाज़ पहले से ही सबसे कम हो.