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

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