स्मार्ट होम चैनल की विशेषता का स्कीमा

action.devices.traits.Channel - यह विशेषता उन डिवाइसों के लिए है जो मीडिया डिवाइस पर टीवी चैनल की सुविधा देते हैं.

availableChannels एट्रिब्यूट के ज़रिए, SYNC के दौरान उपलब्ध चैनलों की सूची, हर उपयोगकर्ता या डिवाइस के हिसाब से शेयर की जानी चाहिए. इस सूची में, वे सभी टॉप या लोकप्रिय चैनल शामिल होने चाहिए जिनकी सदस्यता उपयोगकर्ता या डिवाइस के पास है. क्वेरी की लेटेन्सी कम करने के लिए, हमारा सुझाव है कि चैनल की सूची को छोटा रखें. इसमें 30 या उससे कम चैनल शामिल होने चाहिए.

डिवाइस के एट्रिब्यूट

इस विशेषता वाले डिवाइस, ये एट्रिब्यूट रिपोर्ट कर सकते हैं.SYNC SYNC इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना लेख पढ़ें.

एट्रिब्यूट	टाइप	ब्यौरा
availableChannels	Array	ज़रूरी है. इस डिवाइस के लिए उपलब्ध मीडिया चैनलों के बारे में बताने वाले ऑब्जेक्ट की सूची. हर आइटम, ऐसे चैनल के बारे में बताता है जिसे उपयोगकर्ता इस डिवाइस पर चुन सकता है.
[item, ...]	Object	उपलब्ध मीडिया चैनल.
key	String	ज़रूरी है. इस चैनल के लिए यूनीक आइडेंटिफ़ायर. यह उपयोगकर्ताओं को नहीं दिखता.
names	Array	ज़रूरी है. इस चैनल के लिए, उपयोगकर्ता को दिखने वाले नामों की सूची.
[item, ...]	String	चैनल का नाम.
number	String	इस चैनल के लिए, संख्या वाला आइडेंटिफ़ायर. यह ज़रूरी नहीं है.
commandOnlyChannels	Boolean	(डिफ़ॉल्ट: false) इससे पता चलता है कि डिवाइस, एकतरफ़ा (सही) या दोतरफ़ा (गलत) तरीके से कम्यूनिकेट कर सकता है या नहीं. अगर डिवाइस, इस विशेषता के लिए QUERY इंटेंट या Report State का जवाब नहीं दे सकता, तो इस एट्रिब्यूट को 'सही है' पर सेट करें.

उदाहरण

दो चैनलों की सुविधा देने वाला डिवाइस.

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

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

कोई नहीं.

डिवाइस के निर्देश

इस विशेषता वाले डिवाइस, इन निर्देशों का जवाब दे सकते हैं, जो EXECUTE कार्रवाई का हिस्सा हैं. `EXECUTE` इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, `इंटेंट पूरा करना` लेख पढ़ें.

action.devices.commands.selectChannel

मौजूदा चैनल को किसी खास वैल्यू पर सेट करें.

पैरामीटर

पेलोड में इनमें से कोई एक चीज़ शामिल होती है:

आईडी के हिसाब से चैनल चुनना

पैरामीटर	टाइप	ब्यौरा
channelCode	String	ज़रूरी है. अनुरोध किए गए चैनल के लिए यूनीक आइडेंटिफ़ायर. यह availableChannels में से किसी एक से मेल खाता है.
channelName	String	अनुरोध किए गए चैनल का ऐसा नाम जो आसानी से याद रखा जा सके.
channelNumber	String	अनुरोध किए गए चैनल के लिए, संख्या वाला आइडेंटिफ़ायर.

नंबर के हिसाब से चैनल चुनना

पैरामीटर	टाइप	ब्यौरा
channelNumber	String	ज़रूरी है. अनुरोध किए गए चैनल के लिए, संख्या वाला आइडेंटिफ़ायर.

उदाहरण

KTVU पर स्विच करें

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

चैनल तीन पर स्विच करें.

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

मिलती-जुलती गड़बड़ियां

डिवाइस पर नया चैनल चुनते समय गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

noAvailableChannel

noChannelSubscription

channelSwitchFailed

action.devices.commands.relativeChannel

मौजूदा चैनल को किसी खास संख्या में बढ़ाएं या घटाएं.

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
relativeChannelChange	Integer	ज़रूरी है. चैनलों की संख्या, जिसे बढ़ाना या घटाना है.

उदाहरण

अगले चैनल पर स्विच करें

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

पिछले चैनल पर स्विच करें

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

मिलती-जुलती गड़बड़ियां

डिवाइस के चैनल को अडजस्ट करते समय गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

channelSwitchFailed

action.devices.commands.returnChannel

उस चैनल पर वापस जाएं जिसे उपयोगकर्ता ने पिछली बार देखा था.

पैरामीटर

पैरामीटर	टाइप	ब्यौरा
कोई प्रॉपर्टी नहीं

उदाहरण

पिछली बार देखे गए चैनल पर वापस जाएं

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

मिलती-जुलती गड़बड़ियां

डिवाइस के पिछली बार देखे गए चैनल पर वापस जाते समय गड़बड़ी हुई.

इस्तेमाल की जा सकने वाली वैल्यू:

channelSwitchFailed

डिवाइस में गड़बड़ियां

गड़बड़ियों और अपवादों की पूरी सूची देखें .