स्मार्ट होम वॉल्यूम की विशेषता का स्कीमा

action.devices.traits.Volume - यह विशेषता उन डिवाइसों के लिए है जो वॉल्यूम में बदलाव कर सकते हैं. उदाहरण के लिए, वॉल्यूम को किसी लेवल पर सेट करना, म्यूट करना या अनम्यूट करना.

डिवाइस की ATTRIBUTES

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

विशेषताएं टाइप ब्यौरा
volumeMaxLevel Integer

ज़रूरी है.

यह आवाज़ का ज़्यादा से ज़्यादा लेवल है. इसमें, आवाज़ बंद होने की स्थिति को 0 माना जाता है. Assistant, क्रियाविशेषण वाले निर्देशों (जैसे, 'टीवी की आवाज़ थोड़ी बढ़ाओ') को इसके हिसाब से अडजस्ट करेगी.
volumeCanMuteAndUnmute बूलियन

ज़रूरी है.

इससे पता चलता है कि डिवाइस, आवाज़ को म्यूट और अनम्यूट कर सकता है या नहीं. म्यूट करने का विकल्प अलग होता है, क्योंकि 'म्यूट करें' विकल्प चुनने पर आवाज़ को 0 पर सेट कर दिया जाता है. हालांकि, पिछली आवाज़ को याद रखा जाता है, ताकि अनम्यूट करने पर उसे वापस लाया जा सके. यह वॉल्यूम की स्थिति में दिखता है. अगर वॉल्यूम 5 है और उपयोगकर्ता आवाज़ बंद कर देता है, तो वॉल्यूम 5 ही रहता है और isMuted सही होता है.
volumeDefaultPercentage Integer

(डिफ़ॉल्ट: 40)

उपयोगकर्ता या मैन्युफ़ैक्चरर की ओर से तय की गई डिफ़ॉल्ट आवाज़ का प्रतिशत. स्केल 0 से 100 के बीच होना चाहिए.

मान 0 और 100 के बीच होना चाहिए.
levelStepSize Integer

(डिफ़ॉल्ट: 1)

'<device_name> की आवाज़ बढ़ाओ' जैसी रिलेटिव वॉल्यूम क्वेरी के लिए, डिफ़ॉल्ट स्टेप साइज़.
commandOnlyVolume बूलियन

(डिफ़ॉल्ट: false)

इससे पता चलता है कि डिवाइस, एकतरफ़ा (सही) या दोनों तरफ़ा (गलत) कम्यूनिकेशन का इस्तेमाल करता है. उदाहरण के लिए, अगर अनुरोध भेजने के बाद कंट्रोलर, डिवाइस की नई स्थिति की पुष्टि कर सकता है, तो इस फ़ील्ड की वैल्यू false होगी. अगर यह पुष्टि नहीं की जा सकती कि अनुरोध पूरा हुआ है या डिवाइस की स्थिति का पता नहीं लगाया जा सकता (उदाहरण के लिए, अगर डिवाइस एक पारंपरिक इन्फ़्रारेड रिमोट है), तो इस फ़ील्ड को सही पर सेट करें.

उदाहरण

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

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

डिवाइस की स्थितियां

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

राज्य टाइप ब्यौरा
currentVolume Integer

ज़रूरी है.

वॉल्यूम का मौजूदा प्रतिशत. यह >0 और volumeMaxLevel के बीच होना चाहिए.

कम से कम वैल्यू: 0.
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 किया गया.

कम से कम वैल्यू: 0.

उदाहरण

स्पीकर डिवाइस का वॉल्यूम सेट करना

{
  "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 निर्देश तब मिलता है, जब आवाज़ पहले से ही सबसे कम हो.