خداحافظی با کدهای قدیمی: بررسی توابع منسوخ شده در یونیتی ۶ و جایگزین‌های طلایی آن‌ها

موتور بازی‌سازی یونیتی (Unity) همیشه در حال تکامل است و با انتشار یونیتی ۶ (Unity 6)، این تکامل به اوج خود رسیده است. به عنوان یک توسعه‌دهنده و برنامه‌نویس بازی، یکی از بزرگترین چالش‌ها، همگام ماندن با تغییرات معماری و کدهای منسوخ شده (Deprecated) است. کدهایی که شاید در نسخه‌های ۲۰۱۹ یا ۲۰۲۱ به خوبی کار می‌کردند، اکنون در یونیتی ۶ نه تنها باعث ایجاد اخطارهای آزاردهنده (Warnings) در کنسول می‌شوند، بلکه می‌توانند افت فریم و مشکلات پرفورمنس شدیدی به همراه داشته باشند.

اگر می‌خواهید کدهای سی‌شارپ (C#) شما مانند یک توسعه‌دهنده حرفه‌ای استاندارد، تمیز و کاملاً بهینه برای یونیتی ۶ باشد، این مقاله برای شما نوشته شده است. در ادامه، رایج‌ترین کدهای اولیه و قدیمی که اکنون منسوخ شده‌اند را بررسی کرده و جایگزین‌های مدرن آن‌ها را معرفی می‌کنیم.

۱. جستجوی اشیاء در صحنه؛ پایان دوران FindObjectsOfType

یکی از پرکاربردترین توابع در یونیتی برای پیدا کردن تمام اشیاء یک کلاس خاص در صحنه، تابع FindObjectsOfType بود. در یونیتی ۶، استفاده از این تابع به شدت منع شده و برچسب [Obsolete] دریافت کرده است. دلیل این امر، سربار پردازشی (Overhead) پنهان آن برای مرتب‌سازی نتایج بود.

کد منسوخ شده (بد):

// این کد در یونیتی ۶ اخطار منسوخ شدن می‌دهد

Enemy[] enemies = FindObjectsOfType<Enemy>();

جایگزین مدرن (خوب):

یونیتی در نسخه‌های جدید تابع FindObjectsByType را معرفی کرده است که شما را مجبور می‌کند نحوه مرتب‌سازی (Sorting) را مشخص کنید. اگر نیازی به مرتب‌سازی بر اساس شناسه (Instance ID) ندارید (که در ۹۹٪ مواقع ندارید)، این جایگزین بسیار سریع‌تر عمل می‌کند.

// سریع، بهینه و استاندارد در یونیتی ۶
Enemy[] enemies = FindObjectsByType<Enemy>(FindObjectsSortMode.None);

۲. سیستم ورودی (Input)؛ مرگ Input Manager قدیمی

سیستم ورودی کلاسیک یونیتی (UnityEngine.Input) سال‌ها همراه بازی‌سازان بود. با اینکه هنوز به طور کامل از موتور حذف نشده، اما در رویکردهای مدرن یونیتی ۶ و پروژه‌های تجاری، استفاده از آن عملاً منسوخ و غیرحرفه‌ای تلقی می‌شود. سیستم جدید (New Input System) اکنون استاندارد بلامنازع است.

کد منسوخ و غیرقابل انعطاف (بد):

void Update() {
if (Input.GetKeyDown(KeyCode.Space))
{ Jump(); } }

جایگزین مدرن با New Input System (خوب):

سیستم جدید مبتنی بر رویدادها (Event-driven) کار می‌کند و نیازی به چک کردن مداوم در تابع Update ندارد که این امر باعث ذخیره منابع پردازنده (CPU) می‌شود.

using UnityEngine.InputSystem;
public void OnJump(InputAction.CallbackContext context) {
if (context.performed) {
Jump(); } }

۳. رابط کاربری (UI)؛ کوچ اجباری از Text به TextMeshPro

استفاده از سیستم متنی پیش‌فرض یونیتی (UnityEngine.UI.Text) مدت‌هاست که از رده خارج شده است، اما در یونیتی ۶، پشتیبانی از آن به حداقل رسیده و در پروژه‌های جدید، ابزار پیش‌فرض به طور کامل به TextMeshPro تغییر یافته است. فونت‌های پیکسلی قدیمی جای خود را به سیستم‌های رندر مبتنی بر SDF داده‌اند.

کلاس منسوخ شده (بد):

using UnityEngine.UI;
public Text scoreText;
// کیفیت پایین و رندر سنگین

جایگزین مدرن (خوب):

using TMPro;
public TextMeshProUGUI scoreText;
// کیفیت بی‌نهایت در هر رزولوشن

۴. دسترسی به سیستم ذرات (Particle System)

در نسخه‌های بسیار قدیمی، توسعه‌دهندگان مستقیماً ویژگی‌های ParticleSystem را تغییر می‌دادند. در یونیتی ۶، معماری سیستم ذرات کاملاً ماژولار شده و تلاش برای دسترسی مستقیم به برخی پارامترها با خطای Deprecated مواجه می‌شود.

کد منسوخ شده (بد):

public ParticleSystem myParticles;
void StopMagic() { // این روش کاملا منسوخ شده است myParticles.enableEmission = false; }

جایگزین مدرن (خوب):

اکنون باید از طریق ماژول‌ها (Modules) و ساختارها (Structs) به سیستم ذرات دسترسی پیدا کنید:

public ParticleSystem myParticles; void StopMagic() {
// روش صحیح دسترسی به ماژول انتشار در یونیتی ۶ var emissionModule = myParticles.emission; emissionModule.enabled = false; }

۵. شبکه و مالتی‌پلیر؛ پایان تلخ UNet و طلوع NGO

اگر هنوز از توابعی مانند NetworkBehaviour یا فضای نام UnityEngine.Networking استفاده می‌کنید، بازی شما در یونیتی ۶ کاملاً از کار خواهد افتاد. سیستم قدیمی UNet به طور کامل حذف شده است.

معماری منسوخ شده:

استفاده از [Command]، [ClientRpc] و کلاس‌های ارث‌بری شده از NetworkBehaviourِ قدیمی.

جایگزین مدرن (Netcode for GameObjects - NGO):

یونیتی پکیج Unity.Netcode را به عنوان استاندارد اصلی بازی‌های چندنفره در یونیتی ۶ معرفی کرده است. کلاس‌ها باید از NetworkBehaviour جدید ارث‌بری کنند و ساختار همگام‌سازی متغیرها به NetworkVariable تغییر یافته است.

using Unity.Netcode;
public class PlayerController : NetworkBehaviour {
// متغیرهای شبکه در معماری جدید
public NetworkVariable<int> health = new NetworkVariable<int>(100);
// جایگزین توابع Command قدیمی [ServerRpc]
public void TakeDamageServerRpc(int damage) {
health.Value -= damage; } }

چرا باید کدهای خود را برای یونیتی ۶ ریفکتور (Refactor) کنیم؟

شاید با خود بگویید “کد من کار می‌کند، چرا باید آن را تغییر دهم؟”. پاسخ در سه کلمه خلاصه می‌شود: پرفورمنس، پایداری و آینده‌نگری.

۱. کاهش Garbage Collection: توابع جدید مانند FindObjectsByType طوری طراحی شده‌اند که زباله کمتری در حافظه تولید کنند و مانع از لگ زدن (Spike) بازی شوند.

۲. سازگاری با DOTS: بسیاری از API های جدید به گونه‌ای نوشته شده‌اند که با سیستم جدید داده‌محور یونیتی (ECS و Job System) سازگاری بیشتری داشته باشند.

۳. پشتیبانی رسمی: اگر در استفاده از توابع منسوخ شده به باگ برخورد کنید، یونیتی هیچ تضمینی برای رفع آن در پچ‌های بعدی نمی‌دهد.

نتیجه‌گیری

مهاجرت به یونیتی ۶ تنها به معنای ارتقای گرافیک یا استفاده از نورپردازی‌های پیشرفته نیست. یک بازی روان و موفق، ریشه در کدهای تمیز و بهینه‌شده دارد. با بررسی اسکریپت‌های قدیمی خود و جایگزین کردن کدهای اخطار دار (Obsolete) با API های مدرن، نه تنها سرعت اجرای بازی خود را افزایش می‌دهید، بلکه مهارت برنامه‌نویسی خود را نیز در سطح استانداردهای جهانی و حرفه‌ای نگه می‌دارید.

منابع (References)

• مستندات رسمی موتور بازی‌سازی یونیتی (Unity Documentation) - بخش ارتقاء به نسخه ۶.
• راهنمای رسمی Unity Scripting API - توابع Object.FindObjectsByType.
• تغییرات ساختاری پکیج Netcode for GameObjects (NGO) در سایت رسمی Unity.
• آموزش‌های رسمی معماری New Input System.