"Для разработчиков", "Серверные скрипты", "Описание функций", "Пользователи", "mSetRemoteClientCurrentPlaceID".
Функция для принудительного переключения интерфейса клиентского приложения указанного онлайн-пользователя на конференцию, приват, консоль и другие элементы интерфейса.
Синтаксис
function mSetRemoteClientCurrentPlaceID(const iUIN, iID, iPlaceID: integer; const bShowChatWindow: boolean): integer;
Параметры и возвращаемые значения
Параметр |
Тип |
Значение |
|---|---|---|
iUIN |
integer |
уникальный идентификатор онлайн-пользователя; |
iID |
integer |
UIN / UID / индекс важного сообщения, в зависимости от того, на что нужно переключиться; |
iPlaceID |
integer |
элемент интерфейса чата, куда нужно переключиться: 0 - консоль; 1 - приват; 2 - конференция; 7 - default окно, когда не выбрано ничего; 8 - создание текстовой конференции; 9 - выбор текстовой конференции для подключения; 10 - окно с QR-кодом и ссылками на Android-приложение; 11 - панель важных сообщений (Ctrl + 4); 13 - окно с QR-кодом и ссылкой на приложение для iOS (iPhone/iPad); |
bShowChatWindow |
boolean |
показывать окно чата на переднем плане. |
Результат функции
0 |
всё ок, команда успешно отправлена; |
-1 |
указанного пользователя не существует; |
-2 |
указанный пользователь сейчас отключен от сервера (офлайн); |
-3 |
нельзя отправить эту команду встроенному роботу (UIN 0); |
-4 |
UID не существует; |
-5 |
UIN для привата не существует; |
-6 |
неправильный Place ID. |
Пример
Скрипт переключает окно удалённого пользователя с UIN 6 на консоль и показывает окно приложения MyChat Client поверх всех окон (stay on top), даже если программа работает в терминальной сессии.
begin
mSetRemoteClientCurrentPlaceID(6, -1, 0, true);
end.Результат работы скрипта
До выполнения скрипта:
После выполнения скрипта:
