آموزش JetPlayer در اندروید

JetPlayer Tutorial

پلتفرم اندروید دارای یک موتور JET با محتوای صوتی در برنامه های شما می باشد. اندروید گروه JetPlayer را برای به کار بردن این برنامه ارائه می دهد.

برای دسترسی به محتوای Jet لازم است که از ابزار JetCreator استفاده کنید که همراه AndroidSDK می آید. استفاده از JetCreator در مثال آورده شده است. برای اجرای محتوای ایجاد شده توسط JetCreator، به یک گروه JetPlayer پشتیبانی شده توسط اندروید نیاز دارید.

برای اینکه از JetPlayer استفاده کنید، لازم است که یک شئ از کلاس JetPlayer را به عنوان نمونه بیاورید. که شکل آن را می توانید در زیر مشاهده کنید.

JetPlayer jetPlayer = JetPlayer.getJetPlayer();

کار دیگری که باید انجام دهید، فراخواندن روش loadJetFile و عبور از مسیر فایل jet شما می باشد. پس از این باید آن را به صف داده های JetPlayer اضافه کنید. ترکیب آن را در زیر مشاهده می کنید.

jetPlayer.loadJetFile("/sdcard/level1.jet");
byte segmentId = 0;

// queue segment 5, repeat once, use General MIDI, transpose by -1 octave
jetPlayer.queueJetSegment(5, -1, 1, -1, 0, segmentId++);

آخرین کاری که باید انجام دهید فراخوانی روش اجرا برای آغاز اجرای موسیقی می باشد. ترکیب آن ماند زیر می باشد.

jetPlayer.play();

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

• clearQueue()

صف داده ها را خالی کرده و تمام کلیپ هایی را که برای playback  تعیین شده اند، تخلیه می کند.

• closeJetFile()

محتویات JET   را می بندد.

• getJetPlayer() 

روش کارخانه برای گروه  JetPlayer

• loadJetFile(String path)

یک فایل jet   را در یک مسیر ارائه شده، بارگذاری می کند.

• pause()

 playback مربوط به JET  صف داده ها را متوقف کند.

• release()

آخرین JET Playback  را متوقف می کند و تمام ذخیره های داخلی مربوطه را آزاد می کند.

مثال

مثال زیر استفاده از ابزار JetCreator را برای ایجاد محتوای Jet توضیح می دهد. زمانی که محتوا ایجاد شده باشد می توانید آن را از طریق JetPlayer اجرا کنید.

• برای ایجاد یک برنامه ی اندروید از Eclipse IDE استفاده خواهید کرد و آن را با عنوان  JetPlayer   با نام پکیج com.example.jetplayer نام گذاری کنید. زمان ایجاد این برنامه مطمئن شوید که Target SDKو Compile With در آخرین ورژن Android SDKهستند تا از سطوح بالاتر API  استفاده کنید.

• برنامه های Python  و  WxPython را از اینترنت روی کامپیوتر خود نصب کنید.

• ایجاد کننده ی jet را از طریق پیام واره ی دستور اجرا کنید.

• محتوای Jet را ایجاد و سپس آن را ذخیره کنید.

• برنامه را اجرا و نتایج را بررسی کنید.

برای اجرای این مثال نیاز به یک دستگاه واقعی یا یک شبیه ساز دارید.

استفاده از JetCreator

نصب پایتون

در اولین گام نیاز دارید از JetCreator برای نصب پایتون استفاده کنید. پایتون می تواند از وب سایت رسمی آن یا هرجای دیگری در اینترنت نصب شود.

به یاد داشته باشید که هر دو  ورژن های پایتون باید 2.6 و 2.7 باشد، زیرا در این مثال این ورژن ها استفاده می شوند.

پس از دانلود و نصب پایتون باید مسیری را برای پایتون مشخص کنید. خط  فرمان را باز کرده و فرمانی را که در تصویر زیر مشاهده می کنید، در آن تایپ کنید.

زمانی که مسیر تنظیم شده باشد، می توانید با نوشتن python و سپس فشار دکمه ی enter، آن را بررسی کنید. مانند تصویر .

نصب wxPython

گام بعدی که نیاز دارید نصب wxPython می باشد که از اینترنت قابل دانلود است. پس از دانلود آن، wxPython به طور خودکار روی مسیر پایتون نصب می شود.

اجرای JetCreator

گام بعد رفتن به مسیری است که Jetcrearor در آن وجود دارد، که در tools فولدر SDK می باشد. در تصویر زیر می توانید ببینید.

در فولدر این فرمان را تایپ کرده و enter را فشار دهید

python JetCreator.py

به محض این که شما ضربه وارد کنید، پنجره Jet Creator باز خواهد شد. این امر می تواند چیزی شبیه به این:

 ایجاد Jetcontent

در پنجره ی بالا روی کلید  import کلیک کنید و  JetCreator_demo_1 را از فولدر jet از فولدر محتوای demo در Jetfolder انتخاب کنید، که در تصویر زیر نمایش داده شده است.

زمانی که محتوا را وارد کردید آن را در پنجره ی Jetcreator می بینید، مانند تصویر زیر:

حالا شما می توانید گزینه های مختلفی از Jetcreator  را از طریق لینک آن مشاهده کنید و در نهایت برای ایجاد یک فایل  jet  لازم است که محتوا را از منوی فایل ذخیره کنید.

بررسی نتایج

زمانی که فایل jet را گرفتید، می توانید آن را با استفاده از jetplayer اجرا کنید. کد اصلی برای اجرای آن در زیر ارائه شده است.

JetPlayer jetPlayer = JetPlayer.getJetPlayer();
jetPlayer.loadJetFile("/sdcard/level1.jet");
byte segmentId = 0;

// queue segment 5, repeat once, use General MIDI, transpose by -1 octave
jetPlayer.queueJetSegment(5, -1, 1, -1, 0, segmentId++);
jetPlayer.play();

• قبلی
• بعدی