Nui-callbacks

Обратные вызовы NUI

NUI также может отправлять обратные звонки в игру, используя так называемые «обратные вызовы NUI». В настоящее время они полностью поддерживаются только в Lua, другие языки могут быть использованы, но нуждаются в некотором сложном обходном пути, поскольку они предшествуют функции ссылки в codegen.

Как правило, вы будете использовать функцию RegisterNUICallback в Lua, а REGISTER_NUI_CALLBACK_TYPE родной вместе с обработчиком событий на других языках.

Оба работают очень похоже, и мы опишем оба ниже:

Регистрация обратного вызова NUI в Lua

RegisterNUICallback('getItemInfo', function(data, cb)
    -- POST data gets parsed as JSON automatically
    local itemId = data.itemId

    if not itemCache[itemId] then
        cb({ error = 'No such item!' })
        return
    end

    -- and so does callback response data
    cb(itemCache[itemId])
end)

Регистрация обратного вызова NUI в C#/JS

// JS
RegisterNuiCallbackType('getItemInfo') // register the type

// register a magic event name
on('__cfx_nui:getItemInfo', (data, cb) => {
    const itemId = data.itemId;

    if (!itemCache[itemId]) {
        cb({ error: 'No such item!' });
        return;
    }

    cb(itemCache[itemId]);
});

// C#
RegisterNuiCallbackType("getItemInfo"); // register the type

// register the event handler with manual marshaling
EventHandlers["__cfx_nui:getItemInfo"] += new Action<IDictionary<string, object>, CallbackDelegate>((data, cb) =>
{
    // get itemId from the object
    // alternately you could use `dynamic` and rely on the DLR
    if (data.TryGetValue("itemId", out var itemIdObj))
    {
        cb(new 
        {
            error = "Item ID not specified!"
        });

        return;
    }

    // cast away
    var itemId = (itemIdObj as string) ?? "";

    // same as above
    if (!ItemCache.TryGetValue(itemId, out Item item))
    {
        cb(new 
        {
            error = "No such item!"
        });

        return;
    }

    cb(item);
});

Вызов обратного вызова NUI

// browser-side JS
fetch(`https://${GetParentResourceName()}/getItemInfo`, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json; charset=UTF-8',
    },
    body: JSON.stringify({
        itemId: 'my-item'
    })
}).then(resp => resp.json()).then(resp => console.log(resp));

Чтобы предотвратить задержку запросов, вы должны всегда возвращать обратный вызов - даже если он содержит только пустой объект, или , или аналогичный.{"ok":true}

Пользовательские интерфейсы с NUI