در این مطلب با یک ترفند ساده و با استفاده از کلاس‌های URLLoader و URLRequest وجود و یا عدم وجود یک فایل در ActionScript 3.0 بررسی می‌شود. بدیهی است که کاربرد اصلی این کلاس‌ها بررسی وجود و یا عدم وجود فایل نیست، اما می‌توان از آنها برای این مقصود استفاده کرد.

۱- برای این منظور ابتدا کلاس‌های مورد نیاز را import کنید.

import flash.net.URLLoader;
import flash.net.URLRequest;
import flash.events.IOErrorEvent;
import flash.events.Event;

2- حالا باید یک متغیر از نوع URLLoader تعریف کنیم تا فایل مورد نظر را load کند. در این جا با تعریف دو Event Listener وضعیت لود شدن یا لود نشدن فایل را بررسی می‌کنیم.

var loader:URLLoader = new URLLoader();
loader.addEventListener(Event.COMPLETE, loaded);
loader.addEventListener(IOErrorEvent.IO_ERROR, exit);

loader.load(new URLRequest("D:/Programs/Test.exe"));

دقت کنید که در معرفی آدرس فایل از / به جای \ استفاده شده است.

۳- حالا تابعی را می‌نویسیم که بعد از لود موفق فایل فراخوانی می‌شود.

function loaded(e:Event):void
{
	trace("File Exists.");
	loader.removeEventListener(Event.COMPLETE, loaded);
	loader.removeEventListener(IOErrorEvent.IO_ERROR, exit);
}

دو دستور removeEventListener برای بهینه سازی پروژه اضافه شده اند.

۴- در نهایت تابعی را می‌نویسیم که در صورت عدم لود شدن فایل فراخوانی می‌شود.

function exit(e:IOErrorEvent):void
{
	trace("File not Found.");
	loader.removeEventListener(Event.COMPLETE, loaded);
	loader.removeEventListener(IOErrorEvent.IO_ERROR, exit);
}

لازم به ذکر است که تنها عدم وجود فایل موجب فراخوانی تابع بالا نمی‌شود و ممکن است دلایل دیگری (به جز عدم وجود فایل) موجب بروز خطا شود.

در این مطلب به روش بارگزاری یک فایل قالب بندی CSS و اعمال آن به یک فیلد متنی (Text Fild) می پردازیم ، فایل Css ما خارج از پروژه می باشد (External) ما بعد از بارگزاری آن و آماده سازی ،آن را به باکس متنی خود اعمال می کنیم. این روش برای محتوای HTML بارگزاری شده در تکست فیلد های کاربرد زیادی دارد و می توانید توسط این روش بعد از اتمام پروژه بدون تغییر در فایل فلش تغییرات مورد نیاز خود را روی متون و قالب بندی آنها سایز ، رنگ و دیگر خصوصیات که توسط CSS قابل تنظیم هست ،به روز رسانی کنید.

ابتدا ما فایل ساده ای را به عنوان فایل CSS خود ایجاد می کنیم می توانید این فایل را توسط هر ویرایشگر متنی ایجاد نمایید ، نام فایل را  content.css قرار می دهیم. فایل را در کنار فایل فلش خود قرار دهید.

p {

font-size: 40px;
color: #ff0000;

}

حال در برنامه فلش پروژه ای جدید ایجاد می کنیم و کلاس های مورد نیاز را در بخش اکشن وارد می کنیم

import flash.net.URLLoader;
import flash.net.URLRequest;
import flash.text.StyleSheet;
import flash.events.Event;

حال توسط کدهای زیر فایل را بارگزاری می کنیم تا بتوانیم آن را در مراحل بعد استفاده کنیم

//css تعریف بارگزارنده فایل قالب بندی
var cssLoader:URLLoader = new URLLoader();

//مشخص کردن آدرس و نام فایل خارجی
var cssRequest:URLRequest = new URLRequest("content.css");

//فراخوانی متد مربوطه به بارگزاری فایل تعیین شده
cssLoader.load(cssRequest);

//تعریف رویداد برای زمان کامل شدن بارگزاری
cssLoader.addEventListener(Event.COMPLETE, cssLoadComplete);

در مرحله بعد یک نمونه از کلاس StyleSheet را برای دریافت و آماده سازی محتوای قالب بندی تعریف می کنیم و سپس تابع  cssLoadComplete را برای کنترل کردن رویداد کامل شدن بارگزاری تعریف می کنیم

//StyleSheet تعریف کلاس
var sheet:StyleSheet = new StyleSheet();

//تعریف تابعی برای زمان کامل شدن بارگزاری
function cssLoadComplete(event:Event):void
{

	// چاپ محتوای بارگزاری شده برای تست
	//trace(cssLoader.data);

	//افزودن محتوای بارگزاری شده به کلاس استایل شیت و تبدیل محتوای متنی برای پردازش قالب بندی
	sheet.parseCSS(cssLoader.data);

	// حال می توانیم استایل شیت آماده شده را به تکست فیلد خود اعمال کنیم
	// مربوطه به تکست فیلد مربوطه استفاده می کنیم styleSheetبرای این کار از متد
	textBox.styleSheet = sheet;

	//

	//برای مثال
	textBox.text = "<p>test css iflashlord</p>";

}

همان طور که در کد تابع  مشاهده می کنید بعد از بارگزاری کامل محتوای بارگزاری شده که توسط cssLoader.data قابل دریافت هست را توسط متد parseCSS به sheet تعریف شده اعمال می کنیم ،و در مرحله بعد sheet را به خصوصیت styleSheet تکست فیلدمان (در این مثال textBox) اختصاص می دهیم.

حال می توانیم محتوای خود را به تکست فیلد اعمال کنیم و یا محتوای خارجی External خود را بارگزاری کرده و به تکست فیلد اعمال کنیم.

در این حالت محتوای تکست فیلد از قالب بندی تعریف شده استفاده می کند برای مثال متن نمونه به صورت قرمز و سایز ۴۰  نمایش داده خواهد شد.

توجه داشته باشد که خصوصیت html مربوطه تکست فیلد برای آنلالیز محتوای HTML می بایست فعال شده باشد.

با توجه به این که شاید پروژه نهایی ارائه شده در بخش سوم این آموزش کامل نمی باشد ، سعی می کنیم در این بخش از آموزش نکات ریزی که ممکن هست در کار با صدا ها و مثال های ذکر شده در آموزش قبل به آنها بر بخورید را در این مطلب توضیح دهیم  :

موردی که در آموزش قبلی احتمالا به آن بر خورده اید ، پخش چند باره با کلیک مجدد بر روی دکمه Play می باشد که این امر به دلیل عدم چک کردن در حال پخش بودن می باشد ، ما در این بخش با ایجاد variable ی با نام isPlay از نوع Boolean و مقدار دهی اولیه true به آن می توانیم با مقدار دهی این متغییر در طول برنامه و با شرطی ساده در تابع مربوز به پخش صدا جلوی پخش مجدد را بگیریم.

function onClickPlay(e:MouseEvent)
{
	if (! isPlay)
	{
		myChannel = mySound.play(lastPosition);
		myChannel.soundTransform = myTransform;
		isPlay = true;
	}
}

مورد بعدی برای مواردی که شما نیاز دارید دکمه Stop را هم به همراه Pause و Play داشته باشید که برای این مورد هم در کد زیر بدون حذف این مورد می توانید مشاهده نمایید.

function onClickStop(e:MouseEvent):void
{
	myChannel.stop();
	lastPosition = 0;
	isPlay = false;
}

مورد بعدی برای افرادی که کد را به صورت External می نویسند و نیاز به وارد کردن کلاس ها قبل از استفاده از آنها را دارند نیز در کد زیر مجموعه کلاس ها وارد شده قابل مشاهده می باشد.

این کد برای تمامی ورژن های نرم افزار فلش که اکشن اسکریپت ۳ را پشتبانی می کنند قابل استفاده می باشد

کد نهایی پروژه پخش صدا در اکش اسکریپت ۳ »

import flash.media.Sound;
import flash.net.URLRequest;
import flash.media.SoundChannel;
import flash.events.MouseEvent;
import flash.media.SoundTransform;

var mySound:Sound = new Sound();
var myChannel:SoundChannel = new SoundChannel();
var myTransform:SoundTransform = new SoundTransform();
var lastPosition:Number = 0;
var isPlay:Boolean = true;
mySound.load(new URLRequest("myFavSong.mp3"));
myChannel = mySound.play(0);
myTransform.volume = 0.5;
myChannel.soundTransform = myTransform;

pause_btn.addEventListener(MouseEvent.CLICK , onClickPause);
function onClickPause(e:MouseEvent)
{
	lastPosition = myChannel.position;
	myChannel.stop();
	isPlay = false;
}

play_btn.addEventListener(MouseEvent.CLICK , onClickPlay);
function onClickPlay(e:MouseEvent)
{
	if (! isPlay)
	{
		myChannel = mySound.play(lastPosition);
		myChannel.soundTransform = myTransform;
		isPlay = true;
	}
}

stop_btn.addEventListener(MouseEvent.CLICK, onClickStop);

function onClickStop(e:MouseEvent):void
{
	myChannel.stop();
	lastPosition = 0;
	isPlay = false;
}

توصبه می شود بخش اول مبحث پخش صدا در اکشن اسکریپت ۳ و بخش دوم مبحث پخش صدا در اکشن اسکریپت ۳ و بخش سوم مبحث پخش صدا در اکشن اسکریپت ۳ را نیز مطالعه نمایید

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

در ادامه  بخش اول مبحث پخش صدا در اکشن اسکریپت ۳ به موارد دیگر ذکر شده در آن مطلب می پردازیم :

پخش یک فایل صوتی خارجی (خارج از فلش )

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

برای شروع یک پروژه جدید فلش ایجاد کنید و آن را در محلی مثل دسکتاپ ذخیره کنید و فایل .mp3 مربوطه را نیر در همان محل قرار دهید و فایل صوتی را به myFavSong.mp3 تغییر نام دهید.

حال به پروژه FLa خود برگردید و پنل اکشن را باز نمایید با دکمه F9 و نوشتن کد را شروع می کنیم ، در ابتدا سراغ ساختن new از کلاس Sound می نمایید و آن را به mySound مقدار دهی می کنیم و بعد با استفاده از متد .load این کلاس اقدام به بارگزاری فایل مریوطه می کنیم و در نهایت با استفاده از متد .play اقدام به پخش صدای بارگزاری شده می نماییم.

در زیر به که موارد ذکر شده دقت نمایید :

var mySound:Sound = new Sound();
mySound.load(new URLRequest(”myFavSong.mp3″));
mySound.play();

همان طور که در کد بالا مشاهده می کنید برای استفاده از آدرس یک فایل در بخش load در AS3 از کلاس URLRequerst استفاده می کنیم برای اطلاعات بیشتر در مورد این کلاس می توانید به راهنمای نرم افزار فلش مراجعه نمایید. شما هم اکنون می توانید پروژه را تست نمایید و پخش شدن فایل خارجی بارگزاری شده را تست نمایید.

Stop کردن صدا

تا اینجا درباره انواع پخش کردن صدا با اکشن صحبت کردیم در ادامه به نحوه Stop کردن و یک مثال خواهیم پرداخت.
نکته ای که وجود دارد این است که کلاس Sound متدی برای Stop کردن صدا ندارد و ما برای این کار می بایست از کلاس SoundChannel کمک بگیریم. ما می بایست یک SoundChannel یا کانال صوتی ایجاد کنیم و عملکرد متد play کلاس Sound رو با اون برابر قرار بدیم تا بتونیم از متد SoundCannel برای صدای خودمون استفاده کنیم.

در زیر به توضیحی از متدهای کلاس SoundChannel می پردازیم:

• .stop() –این متد صدای که درون کانال مورد نظری در حال پخش است را Stop می کند.
• .position – این متد محل جاری صدای در حال پخش را در کانال مورد نظر ما بر می گرداند.
• .soundTransform – برای تغییر صدا مثل ولوم و جا به جایی بین پخش سمت چپ و راست می باشد.

در ادامه ما یک پروژه جدید فلش ایجاد می کنیم و قصد داریم یه فایل صوتی خارجی را بارگزاری و پخش کنیم و با یک دکمه Stop در زمان کلیک بر روی آن عمل پخش را Stop نماییم

در مرحله اول یک دکمه Button از پانل کامپوننت ها Window>Components درگ کرده و در صفحه قرار دهید و instance name آن را stop_btn قرار دهید ، شما می تونید از تب پارامتر های کامپوننت lable دکمه را به Stop تغییر دهید.

هم اکنون دکمه ای ایجاد کردیم که در زمان کلیک بر روی آن صدا می بایست Stop شود.
پنل اکشن را باز نمایید و یا بر روی تنها فریم موجود در تایم لاین TimeLine راست کلیک کرد و Actions را انتخاب نمایید تا پانل اکشن نمایش داده شود.

مرحله بعد شروع نوشتن کد ها می باشد طبق کدهایی که در مرحله های قبلی توضیح دادیم کلاس Sound را برای بارگزاری صدا ایجاد می کنیم و صدا را با متد play پخش می کنیم.

var mySound:Sound = new Sound();
mySound.load(new URLRequest(”myFavSong.mp3″));
mySound.play();

ما برای کنترل بر روی صدا و اعمال متد Stop همان طور که در اول هم گفتیم می بایست از SoundChannel استفاده کنیم در کدی در زیر می بینید ما این کلاس تعریف کردیم:

var mySound:Sound = new Sound();
var myChannel:SoundChannel = new SoundChannel();
mySound.load(new URLRequest(”myFavSong.mp3″));
mySound.play();

برای این که کلاس SoundChannel بر روی صدای ما کنترل داشته باشد نیاز به این داریم که پیوندی بین این دو ایجاد نماییم و این کار را با جا به جایی خط آخر کد بالا انجام می دهیم ، در واقع عمل play را به کلاس SoundChannel که در اینجا با myChannel تعریف شده می دهیم.

var mySound:Sound = new Sound();
var myChannel:SoundChannel = new SoundChannel();
mySound.load(new URLRequest(”myFavSong.mp3″));
myChannel = mySound.play();

حال به راحتی می توانید با ایجاد رویداد برای دکمه از متد stop مریوط به کلاس SoundChannel استفاده کنیم.

var mySound:Sound = new Sound();
var myChannel:SoundChannel = new SoundChannel();
mySound.load(new URLRequest(”myFavSong.mp3″));
myChannel = mySound.play();

stop_btn.addEventListener(MouseEvent.CLICK, onClickStop);

function onClickStop(e:MouseEvent):void{
myChannel.stop();
}

حال می توانید پروژه را تست نمایید در زمان اجرا به صورت خودکار صدا می بایست پخش شود و با کلیک بر روی دکمه Stop می بایست صداد Stop شود.

توصبه می شود بخش اول مبحث پخش صدا در اکشن اسکریپت ۳ را نیز مطالعه نمایید