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

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

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

डिवाइस की विशेषताएं

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

विशेषताएं	Type	जानकारी
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

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

पैरामीटर

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

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

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

नंबर के मुताबिक चैनल चुनें

पैरामीटर	Type	जानकारी
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

मौजूदा चैनल में इससे मिलती-जुलती रकम जोड़ें.

पैरामीटर

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

उदाहरण

अगले चैनल पर जाएं

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

पिछले चैनल पर जाना

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

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

डिवाइस के चैनल में बदलाव करने के दौरान कोई गड़बड़ी हुई.

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

channelSwitchFailed

action.devices.commands.returnChannel

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

पैरामीटर

पैरामीटर	Type	जानकारी
कोई प्रॉपर्टी नहीं

उदाहरण

पिछले चैनल पर वापस जाना

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

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

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

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

channelSwitchFailed

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

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