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

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