API संदर्भ

Key Value

सेटिंग से अलग, डिवाइस-विशिष्ट स्थायी JSON ऐप डेटा, जो डेवलपर मोड के बिना उपलब्ध है। अनुमत कुंजियाँ: last_file_path, quick_note_draft, recent_searches, recent_save_dirs, chat_input_text:peer:ID और chat_input_text:channel:ID (ID खाली न हो)। मान एक डिवाइस के क्लाइंटों के बीच साझा होते हैं।

वर्तमान में Key Value से सहेजा डेटा

ये ऐप डेटा कुंजियाँ अभी keyValue और setKeyValue स्वीकार करते हैं। तालिका वर्तमान क्लाइंट मान ढाँचे बताती है, सर्वर द्वारा लागू JSON संरचना नहीं। ID खाली नहीं होना चाहिए। मान स्थायी हैं और एक डिवाइस के क्लाइंटों में साझा हैं; वे सेटिंग नहीं हैं। अनुपस्थित मान null लौटाते हैं। value तर्क गैर-null JSON है; null से कुंजी नहीं मिटाई जा सकती। उदाहरण डेटा संरचनाएँ हैं, उपयोगकर्ता की वास्तविक सहेजी सामग्री नहीं।

KeyJSON मान का ढाँचाउद्देश्य
last_file_path{ rootPath: string, fullPath: string, selectedPath: string }अंतिम फ़ाइल-ब्राउज़र स्थान: रूट, पूरा पथ और चुना पथ।
quick_note_draftstringन भेजा गया त्वरित नोट टेक्स्ट।
recent_searchesstring[]हाल के खोज शब्द, नवीनतम पहले; सूची छोटी करना क्लाइंट का काम है।
recent_save_dirsstring[]हाल में चुनी सेव या अपलोड डायरेक्टरी, नवीनतम पहले; सूची छोटी करना क्लाइंट का काम है।
chat_input_text:peer:IDstringID से पहचाने पीयर का न भेजा गया चैट टेक्स्ट।
chat_input_text:channel:IDstringID से पहचाने चैनल का न भेजा गया चैट टेक्स्ट।

प्रकार परिभाषाएँ

graphql
type Mutation {
  setKeyValue(key: String!, value: JSON!): Boolean!
}

type Query {
  keyValue(key: String!): JSON
}

scalar JSON

ऑपरेशन

mutation

setKeyValue

अनुमत Key Value कुंजी के लिए JSON ऐप डेटा स्थायी सहेजें। एन्कोड किए मान 65,536 बाइट से अधिक नहीं होने चाहिए। बदलाव पर true और समान होने पर false लौटाता है; यह API सेटिंग नहीं बदलता।

graphql
# Save JSON application data up to 65,536 encoded bytes; returns whether the stored value changed.
mutation setKeyValue($key: String!, $value: JSON!) {
  setKeyValue(key: $key, value: $value)
}
query

keyValue

अनुमत Key Value कुंजी का JSON ऐप डेटा पढ़ें। गुम कुंजियाँ null लौटाती हैं। यह API सेटिंग नहीं पढ़ता।

graphql
# Read JSON application data by key; returns null when absent and does not read preferences.
query keyValue($key: String!) {
  keyValue(key: $key)
}