स्मार्ट होम वॉल्यूम ट्रेल स्कीमा
action.devices.traits.Volume
- यह आवाज़ उन डिवाइस से जुड़ी है जिनमें आवाज़ को कम या ज़्यादा करने की सुविधा है. उदाहरण के लिए, आवाज़ को किसी खास लेवल, म्यूट या अनम्यूट करने के लिए.
डिवाइस की विशेषताएं
इस सुविधा का इस्तेमाल करने वाले डिवाइस,
SYNC
की कार्रवाई के तहत, इन एट्रिब्यूट की शिकायत कर सकते हैं. SYNC
इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
विशेषताएं | Type | जानकारी |
---|---|---|
volumeMaxLevel |
Integer |
ज़रूरी है. 0 (म्यूट) की बेसलाइन मानते हुए, ज़्यादा से ज़्यादा वॉल्यूम लेवल. Assistant, बोले जाने वाले निर्देशों को अडजस्ट करेगी. उदाहरण के लिए, 'टीवी को थोड़ा तेज़' बनाओ. |
volumeCanMuteAndUnmute |
बूलियन |
ज़रूरी है. इससे पता चलता है कि डिवाइस की आवाज़ को म्यूट और अनम्यूट किया जा सकता है या नहीं. म्यूट एक अलग विकल्प है. इसकी वजह यह है कि पिछले म्यूट को ध्यान में रखते हुए, 'म्यूट करें' विकल्प की मदद से आवाज़ को 0 पर सेट किया जाता है. ऐसा करने से, म्यूट की आवाज़ वापस आ जाती है. यह वॉल्यूम की स्थिति में दिखता है—अगर वॉल्यूम 5 है, और उपयोगकर्ता म्यूट करता है, तो वॉल्यूम 5 और |
volumeDefaultPercentage |
Integer |
(डिफ़ॉल्ट: उपयोगकर्ता या मैन्युफ़ैक्चरर के तय किए गए डिफ़ॉल्ट वॉल्यूम के हिसाब से वॉल्यूम (प्रतिशत में). स्केल 0-100 होना चाहिए. |
levelStepSize |
Integer |
(डिफ़ॉल्ट: रिलेटिव वॉल्यूम क्वेरी के लिए, डिफ़ॉल्ट स्टेप साइज़. जैसे, <device_name> पर आवाज़ तेज़ करना. |
commandOnlyVolume |
बूलियन |
(डिफ़ॉल्ट: इससे पता चलता है कि डिवाइस का इस्तेमाल करने के लिए, एकतरफ़ा (सही) या दोतरफ़ा बातचीत (गलत) का इस्तेमाल किया गया है या नहीं. उदाहरण के लिए, अगर नियंत्रक अनुरोध भेजने के बाद नए डिवाइस की स्थिति की पुष्टि कर सकता है, तो यह फ़ील्ड गलत होगा. अगर इस बात की पुष्टि नहीं की जा सकती कि अनुरोध सही तरीके से किया गया है या नहीं या डिवाइस की स्थिति के बारे में जानना है, तो इस फ़ील्ड को 'सही' पर सेट करें. उदाहरण के लिए, अगर डिवाइस पारंपरिक इन्फ़्रारेड रिमोट है, तो ऐसा किया जा सकता है. |
उदाहरण
स्पीकर डिवाइस, जिसे म्यूट किया जा सकता है और मौजूदा स्थिति की रिपोर्ट कर सकता है
{ "volumeMaxLevel": 11, "volumeCanMuteAndUnmute": true, "levelStepSize": 2, "commandOnlyVolume": false, "volumeDefaultPercentage": 6 }
डिवाइस की स्थिति
इस सुविधा का इस्तेमाल करने वाली इकाइयां, QUERY
की कार्रवाई के तहत, इन स्थितियों की जानकारी दे सकती हैं. QUERY
इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
राज्य | Type | जानकारी |
---|---|---|
currentVolume |
Integer |
ज़रूरी है. आवाज़ का मौजूदा प्रतिशत. यह |
isMuted |
बूलियन |
अगर |
उदाहरण
स्पीकर डिवाइस, जिसे म्यूट किया जा सकता है और मौजूदा स्थिति की रिपोर्ट कर सकता है
{ "currentVolume": 5, "isMuted": false }
डिवाइस के निर्देश
इस सुविधा का इस्तेमाल करने वाले डिवाइस, EXECUTE
की कार्रवाई के तहत, इन निर्देशों का पालन कर सकते हैं. EXECUTE
इंटेंट को हैंडल करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना देखें.
action.devices.commands.mute
डिवाइस को म्यूट या अनम्यूट करता है.
पैरामीटर
पैरामीटर | Type | जानकारी |
---|---|---|
mute |
बूलियन |
ज़रूरी है. किसी डिवाइस को म्यूट करना है या किसी डिवाइस को अनम्यूट करना है. |
उदाहरण
स्पीकर डिवाइस को म्यूट करना
{ "command": "action.devices.commands.mute", "params": { "mute": true } }
action.devices.commands.setVolume
volumeMaxLevel
के आधार पर, अनुरोध किए गए लेवल पर वॉल्यूम सेट करें.
पैरामीटर
पैरामीटर | Type | जानकारी |
---|---|---|
volumeLevel |
Integer |
ज़रूरी है.
|
उदाहरण
स्पीकर डिवाइस का पूरा वॉल्यूम सेट करना
{ "command": "action.devices.commands.setVolume", "params": { "volumeLevel": 6 } }
action.devices.commands.volumeRelative
volumeMaxLevel
के आधार पर, वॉल्यूम को n पर सेट करें या कम या ज़्यादा करें. रिलेटिव स्केल का इस्तेमाल करने वाले निर्देशों के लिए, Assistant सही तरीके से उपलब्ध चरणों को स्केल करने के लिए n चुनेगी. उदाहरण के लिए, टीवी को और तेज़ बनाने के लिए, टीवी को थोड़ा तेज़ बनाने की सुविधा ज़्यादा निर्देश सेट करेगी.
पैरामीटर
पैरामीटर | Type | जानकारी |
---|---|---|
relativeSteps |
Integer |
ज़रूरी है. 'कम' के लिए नेगेटिव. |
उदाहरण
सिर्फ़ कमांड वाले मोड में, स्पीकर डिवाइस की रिलेटिव वॉल्यूम सेट करना
{ "command": "action.devices.commands.volumeRelative", "params": { "relativeSteps": -1 } }
डिवाइस में गड़बड़ी
गड़बड़ियों और अपवादों की पूरी सूची देखें.volumeAlreadyMax
: डिवाइस को पहले से ही सबसे ज़्यादा वॉल्यूम परVolumeUp
निर्देश मिलता है.volumeAlreadyMin
: डिवाइस कोVolumeDown
का निर्देश मिलता है. यह निर्देश तब दिया जाता है, जब डिवाइस की आवाज़ सबसे कम कीमत पर सेट हो.