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

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

डिवाइस की गड़बड़ियां

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