← Cloudflare Realtime / realtime / realtimekit

Хранение и трансляция

RealtimeKit Stores API позволяет создавать несколько хранилищ данных реального времени в формате «ключ-значение». Пользователи могут подписываться на изменения в хранилище и получать обновления в реальном времени. Данные хранятся до тех пор, пока сеанс активна.

Создание хранилища

Можно создать хранилище в реальном времени (изменения синхронизируются с другими пользователями):

Параметр	Тип	Описание	Обязательный
`name`	string	Имя хранилища	true

Чтобы создать хранилище:

const stores = useRealtimeKitSelector((m) => m.stores);
const store = stores.create('myStore');

const store = meeting.stores.create('myStore');

const store = meeting.stores.create('myStore');

val meeting = RealtimeKitMeetingBuilder.build(activity)
val store = meeting.stores.create("myStore")

let meeting = RealtimeKitiOSClientBuilder().build()
let store = meeting.stores.create(name: "myStore")

Обновите хранилище

В хранилище можно добавлять, обновлять и удалять записи:

Параметр	Тип	Описание	Обязательный
`key`	string	Уникальный идентификатор, используемый для сохранения или обновления значения в хранилище	Да
`value`	StoreValue	Значение, которое можно сохранить для ключа	Да

type StoreValue = string | number | object | array;

const stores = useRealtimeKitSelector((m) => m.stores.stores);
const store = stores.get("myStore");

await store.set("user", { name: "John Doe" });

await store.update("user", { age: 34 }); // { name: 'John Doe', age: 34 }

await store.delete("user");

type StoreValue = string | number | object | array;

const { stores } = meeting.stores;
const store = stores.get("myStore");

await store.set("user", { name: "John Doe" });

await store.update("user", { age: 34 }); // { name: 'John Doe', age: 34 }

await store.delete("user");

type StoreValue = string | number | object | array;

const { stores } = meeting.stores;
const store = stores.get("myStore");

await store.set("user", { name: "John Doe" });

await store.update("user", { age: 34 }); // { name: 'John Doe', age: 34 }

await store.delete("user");

val store = meeting.stores.get("myStore")

store.set("user", mapOf("name" to "John Doe"))

let store = meeting.stores.get(name: "myStore")
store.set("user", ["name": "John Doe"])

На ключ хранилища можно подключить слушателей событий, которые срабатывают при изменении значения.

const stores = useRealtimeKitSelector((m) => m.stores.stores);
const store = stores.get('myStore');
store.subscribe('key', (data) => {
    console.log(data);
});

// subscribe to all keys of a store
store.subscribe('\*', (data) => {
console.log(data);
});

store.unsubscribe('key');

const { stores } = meeting.stores;
const store = stores.get('myStore');
store.subscribe('key', (data) => {
    console.log(data);
});

// subscribe to all keys of a store
store.subscribe('\*', (data) => {
console.log(data);
});

store.unsubscribe('key');

const { stores } = meeting.stores;
const store = stores.get('myStore');
store.subscribe('key', (data) => {
    console.log(data);
});

// subscribe to all keys of a store
store.subscribe('\*', (data) => {
console.log(data);
});

store.unsubscribe('key');

val store = meeting.stores.create("myStore")
val keyChangeCallback = { key: String, value: Any? ->
  println(value)
}
store.subscribe("key", keyChangeCallback)

// Subscribe to all keys
store.subscribe(RtkStore.WILDCARD_KEY) { key, value ->
  println(value)
}

store.unsubscribe("key", keyChangeCallback)

let store = meeting.stores.create(name: "myStore")
let keyChangeCallback: ((String, (Any?)) -> Void) = { key, value in
    print(value ?? "null")
}
store.subscribe(key: "key", onChange: keyChangeCallback)

// Subscribe to all keys
store.subscribe(key: RtkStore.Companion().WILDCARD_KEY) { key, value in
    print(value ?? "null")
}

store.unsubscribe(key: "key", onChange: keyChangeCallback)

Получение данных хранилища

Вы можете получить данные, хранящиеся в хранилище:

const stores = useRealtimeKitSelector((m) => m.stores.stores);
const store = stores.get('myStore');

// fetch value for a specific key
const data = store.get('key');

// fetch all the data in the store
const data = store.getAll();

const { stores } = meeting.stores;
const store = stores.get('myStore');

// fetch value for a specific key
const data = store.get('key');

// fetch all the data in the store
const data = store.getAll();

const { stores } = meeting.stores;
const store = stores.get('myStore');

// fetch value for a specific key
const data = store.get('key');

// fetch all the data in the store
const data = store.getAll();

val store = meeting.stores.create("myStore")

// fetch value for a specific key
val data = store.get("key")

// fetch all the data in the store
val data = store.getAll()

let store = meeting.stores.create(name: "myStore")

// fetch value for a specific key
store.get(key: "key")

// fetch all the data in the store
store.getAll()