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

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

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

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

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

विशेषताएं टाइप ब्यौरा
availableChannels रेंज

ज़रूरी है.

इस डिवाइस के लिए उपलब्ध मीडिया चैनलों की जानकारी देने वाली चीज़ों की सूची. हर आइटम एक ऐसे चैनल के बारे में बताता है जिसे उपयोगकर्ता इस डिवाइस पर चुन सकता है.

[item, ...] ऑब्जेक्ट

उपलब्ध मीडिया चैनल.

key स्ट्रिंग

ज़रूरी है.

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

names रेंज

ज़रूरी है.

इस चैनल के लिए उपयोगकर्ताओं को दिखने वाले नामों की सूची.

[item, ...] स्ट्रिंग

चैनल का नाम.

number स्ट्रिंग

इस चैनल के लिए वैकल्पिक न्यूमेरिक आइडेंटिफ़ायर.

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 स्ट्रिंग

ज़रूरी है.

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

channelName स्ट्रिंग

अनुरोध किए गए चैनल का उपयोगकर्ता के लिए आसान नाम.

channelNumber स्ट्रिंग

अनुरोध किए गए चैनल का न्यूमेरिक आइडेंटिफ़ायर.

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

पैरामीटर टाइप ब्यौरा
channelNumber स्ट्रिंग

ज़रूरी है.

अनुरोध किए गए चैनल का न्यूमेरिक आइडेंटिफ़ायर.

उदाहरण

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

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

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