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

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

डिवाइस ATTRIBUTES

इस विशेषता वाले डिवाइस ये रिपोर्ट कर सकते हैं 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
}

डिवाइस COMMANDS

इस विशेषता वाले डिवाइस इन सुविधाओं के लिए काम कर सकते हैं 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
  }
}

डिवाइस ERRORS

पूरी सूची देखें गड़बड़ियों और अपवाद के तौर पर मार्क किया जा सकता है.

• volumeAlreadyMax: डिवाइस को VolumeUp निर्देश तब मिलता है, जब वह ऐसा होता है वॉल्यूम सबसे ज़्यादा पर है.
• volumeAlreadyMin: डिवाइस को VolumeDown निर्देश तब मिलता है, जब वह ऐसा होता है पहले से ही सबसे कम वॉल्यूम पर.