स्मार्ट होम चैनल के ट्रैट स्कीमा

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

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

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

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

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

उदाहरण

ऐसा डिवाइस जिस पर दो चैनल काम करते हों.

{
  "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

डिवाइस से जुड़ी गड़बड़ियां

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