پرش به مطلب اصلی

OnUnoccupiedVehicleUpdate

توضیحات​

این کالبک زمانی فراخوانده می‌شود که کلاینت بازیکن موقعیت وسیله نقلیه‌ای که رانندگی نمی‌کند را به‌روزرسانی/همگام‌سازی کند. این می‌تواند خارج از وسیله نقلیه یا زمانی که بازیکن مسافر وسیله نقلیه‌ای است که راننده ندارد، اتفاق بیفتد.

نامتوضیحات
vehicleidشناسه وسیله نقلیه‌ای که موقعیت آن به‌روزرسانی شده است.
playeridشناسه بازیکنی که به‌روزرسانی همگام‌سازی موقعیت وسیله نقلیه را ارسال کرده است.
passenger_seatشناسه صندلی اگر بازیکن مسافر باشد. 0=در وسیله نقلیه نیست، 1=مسافر جلو، 2=عقب چپ 3=عقب راست 4+ برای کوچ/اتوبوس و غیره با صندلی‌های مسافر زیاد است.
Float:new_xمختصات جدید X وسیله نقلیه.
Float:new_yمختصات جدید Y وسیله نقلیه.
Float:new_zمختصات جدید Z وسیله نقلیه.
Float:vel_xسرعت جدید X وسیله نقلیه.
Float:vel_yسرعت جدید Y وسیله نقلیه.
Float:vel_zسرعت جدید Z وسیله نقلیه.

مقادیر برگشتی​

همیشه اول در filterscript ها فراخوانده می‌شود بنابراین برگرداندن 0 در آنجا سایر اسکریپت‌ها را نیز از پردازش آن مسدود می‌کند.

مثال‌ها​

public OnUnoccupiedVehicleUpdate(vehicleid, playerid, passenger_seat, Float:new_x, Float:new_y, Float:new_z, Float:vel_x, Float:vel_y, Float:vel_z)
{
    // Check if it moved far
    if (GetVehicleDistanceFromPoint(vehicleid, new_x, new_y, new_z) > 50.0)
    {
        // Reject the update
        return 0;
    }

    return 1;
}

نکته‌ها​

هشدار
  • این کالبک خیلی مکرر در هر ثانیه برای هر وسیله نقلیه غیراشغال فراخوانده می‌شود. باید از پیاده‌سازی محاسبات فشرده یا عملیات فشرده نوشتن/خواندن فایل در این کالبک خودداری کنید.
  • GetVehiclePos مختصات قدیمی وسیله نقلیه را قبل از این به‌روزرسانی برخواهد گرداند.

کالبک‌های مرتبط​

کالبک‌های زیر ممکن است مفید باشند، زیرا به نوعی با این کالبک مرتبط هستند.

  • OnTrailerUpdate: زمانی فراخوانده می‌شود که موقعیت trailer توسط کلاینت همگام‌سازی شود.