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

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

डिवाइस 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
}

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

इस trait वाली इकाइयां 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 निर्देश मिलता है.