カテゴリー: Develop

今回は正確に言うと検証ではなく、改造です・・・。
今後のバージョンアップ等を考えると同期が取れなくなるのでお勧めしません。実装される方は一応自己責任でお願いします。
ドキュメントには掲載されていないのですが、
jp.progression.core.managers.HistoryManager
という履歴を管理するクラスがあります。基本的にはブラウザの「戻る」「進む」ボタンに対応してシーンを遷移させる働きをしています。これを使用しているクラスとしては
jp.progression.core.managers.KeyboardManager
jp.progression.core.managers.SceneManager
jp.progression.core.ui.CastObjectContextMenu
の3つがあります。ｺﾝﾃｷｽﾄとかは標準的に表に出てくるので使っている人も多いと思います。
で、これと同じ働きをする「back」「next」ボタンをFlash内で実装する場合

HistoryManager.back();//戻る
HistoryManager.forward();//進む

という感じになります。
ただ履歴とその中における現在の位置の関係が分からないため、これ以上戻れない、進めない状態になったときにボタンを殺したりすることができません。（その口を見つけられていないだけかもしれないけど）
つまりHistoryManager._positionとHistoryManager._histories.lengthの関係をチェックして、フロントのボタンの制御を行える口を用意したいなと・・。
ただposition、histories共にprivate static属性のためextendsもできず・・・ということでHistoryManagerに２つメソッドを追加してしまいました。

apeirophobia: Loaderの読み込み強制終了 Loader.close編、apeirophobia: Loaderの読み込み強制終了 Loader.unload編の続き。Progression3でやるとどうなるか？の検証。
主要なコードは以下の通り。本当はもっとスマートな書き方がCastImageLoaderにはありますが、敢えてここはcontentsLoaderInfoと比較するためにこの記述の仕方で・・。
CODE:1

_loader = new CastImageLoader();
//CastImageLoaderイベント
_loader.addEventListener(CastEvent.CAST_LOAD_COMPLETE, _loaded_Loader);
_loader.addEventListener(CastEvent.CAST_LOAD_START, function() { trace("CastImageLoader::ロード開始");_output.text = "CAST_LOAD_START"} );
_loader.addEventListener(Event.UNLOAD, function() { trace("CastImageLoader::アンロードされました"); _output.text = "CAST_REMOVED" } );
//contentLoaderInfoイベント
_loader.contentLoaderInfo.addEventListener(Event.COMPLETE, function() { trace("contentLoaderInfo::ロード完了"); } );
_loader.contentLoaderInfo.addEventListener(Event.OPEN, function() { trace("contentLoaderInfo::ロード開始"); );
_loader.contentLoaderInfo.addEventListener(Event.UNLOAD, function() { trace("contentLoaderInfo::アンロードされました"); } );
・・・
_bt_cancel.onCastMouseDown = function()
{
trace("CLOSE実行");
if (_loader.contentLoaderInfo && _loader.contentLoaderInfo.bytesLoaded < _loader.contentLoaderInfo.bytesTotal)
{
_loader.close();
}
_loader.unload();
}
・・・
private function _loaded_Loader(e:Event):void
{
trace("CastImageLoader::ロード完了");
addChildAt(_loader,0);
}

で、一点注意点としてはCastEventは”UNLOAD”イベントを持たないので、その部分だけはEvent.UNLOADを使用します。あ、あとcontentLoaderInfoではなく直接CastImageLoaderを監視します。
ﾌﾟﾚﾋﾞｭｰ/ﾀﾞｳﾝﾛｰﾄﾞｼﾐｭﾚｰﾄでの実行結果は

１：読み込み中にclose実行＞読み込みは中断されず、COMPLETEイベント発生。ただし_loaderは表示されない。
２：読み込み前にclose実行＞特に問題なし
３：読み込み後にclose実行＞_loader消去
４：読み込み中にclose実行後、再度読み込み＞2回目の読み込みCOMPLETEイベントが発生するが、_loaderが表示されない。
５：読み込み完了後にclose実行後、再度読み込み＞問題なく表示
６：読み込み後、再度読み込み中にclose実行＞unloadが無視され、COMPLETE発生後表示されてしまう。

という感じに。読み込みは中断されずCOMPLETEイベントは発生してしまいますが、表示されることはありません。
ただし４、５、６あたりが挙動が不審なところで、読み込み中にunloadを実行する、もしくは一度unlaod無しでCOMPLETEしてしまうとcontents(DisplayObject)の制御が利かなくなるようです。（ExLoader、ExImageLoader、CastImageLoaderの中を見てみましたが、ちょっと原因良く分からなかった）
HTTP経由での実行結果は

１：読み込み中にclose実行＞読み込み中断。
２：読み込み前にclose実行＞特に問題なし
３：読み込み後にclose実行＞_loader消去
４：読み込み中にclose実行後、再度読み込み＞問題なし
５：読み込み完了後にclose実行後、再度読み込み＞問題なく表示
６：読み込み後、再度読み込み中にclose実行＞問題なし

という結果になりました。ﾌﾟﾚﾋﾞｭｰ環境でおかしかった４、５、６辺りはHTTP経由では問題ないようです。
で、話はちょっと横にそれますが、contentsLoaderInfoのイベントとのタイミングですが、普通にLoadingした場合

CastImageLoader::ロード開始
contentLoaderInfo::ロード開始
CastImageLoader::ロード完了
contentLoaderInfo::ロード完了

というようにCastImageLoaderのイベントのほうが先に実行されています。ステキです。
では続いて、CastImageLoaderに最適と思われる記述の仕方をしてみます。

外部イメージのローディング途中で他の処理やｼｰﾝに遷移したい場合等、ローディングを任意に中止する部分で現在はまり中ということで検証を時系列的にメモ。
“Loader”ｸﾗｽには”close”と”unload”という似たようなﾒｿｯﾄﾞが2つほどある。
closeは

Loader インスタンスに対して現在進行中の load() メソッドの処理をキャンセルします。

一方unloadは

load() メソッドを使用してロードされた、この Loader オブジェクトの子を削除します。関連したLoaderInfo オブジェクトの property は null にリセットされます。他のオブジェクトが参照している可能性があるため、子は必ずしも破棄されるとは限りません。ただし、Loader オブジェクトの子ではなくなります。

と定義されている。
とりあえず”close”から検証してみる。
CODE:1

_loader = new Loader();
_loader.contentLoaderInfo.addEventListener(Event.OPEN, function() { trace("ロード開始");} );
_loader.contentLoaderInfo.addEventListener(Event.UNLOAD, function(){trace("アンロードされました")});
_loader.contentLoaderInfo.addEventListener(Event.COMPLETE, _loaded_Loader);
・・・
//キャンセルボタン（※CastButtonを使用）
_bt_cancel.onCastMouseDown = function(){ _loader.close(); }
・・・
private function _loaded_Loader(e:Event):void
{
trace("ロード完了");
addChildAt(_loader,0);
}

既にこの時点でCLOSEイベントを取得する口が見つからない（汗　EVENT.CLOSEは”Socket”,”XMLSocket”だけにしか用意されていないイベント。つまり発動したとしても結果を拾えないという謎な感じになっている。

Progressionの便利機能の一つに

sync : Boolean
ブラウザ上でコンテンツを実行している場合に、URL と Progression インスタンスのシーンを同期させるかどうかを取得または設定します。 同一コンテンツ上で有効化できる Progression インスタンスは 1 つのみであり、複数に対して有効化を試みた場合、最後に有効化された Progression インスタンス以外の sync プロパティは自動的に false に設定されます。

があるわけですが、”Index(CastDocument)”クラス内でコマンドを使って外部ファイルのローディング処理等をしつつ、”sync=true”にしていると、コマンド処理待ちをすっ飛ばして自動的にfirstSceneIdｼｰﾝに遷移してしまいます。（prog.goto( prog.firstSceneId );”を記述していない場合、ﾌﾟﾚﾋﾞｭｰ環境では遷移しないのですがﾌﾞﾗｳｻﾞ上でみると遷移しちゃう）
各シーン毎に必要なものを読み込む様な形であれば問題ないのですが、先読みデータ前提で各シーンの設定していると（例えば外部イメージをbitmapdataとして保持して、そこから呼び出したり）、読み込み前のためにnullになってしまってｴﾗｰが出てきます。
でわどするか？っつーと”prog.sync = false;”の設定をコマンドの中にいれて設定を同期させてしまいます。つまり先読み処理が終わった後、且つ最初のｼｰﾝへの移動の間で設定する。こんな感じ
CODE-1

_list = new SerialList();
_list.addCommand(
・・・
//先読み処理終了
,function() { prog.sync = true; }
,new Goto(prog.firstSceneId)
);
_list.execute();

これで多分大丈夫。
多分・・。

この問題（apeirophobia: Progressionの中でPV3D）がまだクリアになっていないのだけど、ちょっと先に進みます。今回は外部データの読み込みを試してみます。
一般的に外部データとして想定されるものはxml,json,jpg,swf等があります。as3になってバイナリも読み込めるのですがそれはまた別の話で。
最初に至極まっとうにXMLでやってみます。IndexScene.asの_onLoadの中に組み込んでみます。
#code-1

private var _loadURL:LoadURL;
～
protected override function _onLoad():void {
_loadURL = new LoadURL(new URLRequest("test.xml"));
_loadURL.after(parseXML);
_loadURL.execute();
}
private function parseXML():void {
var myXML:XML = new XML(_loadURL.data);
trace(myXML);
}

こんな感じ。
次にcommandを使ってみる。

続いてSceneに色々貼り付けるのに”jp.progression.casts”系を使用してみます。
まずは”AboutScene”。前回で作成した適当なMovieClip”div_scene1″とJPG画像をcast系に変更。bmは以前は”name”を指定していたものを”id”に変更。（一応nameもありますが、getInstanceByIdを検証するためidにしておく）

	mc1 = new div_scene1() as CastMovieClip;
//bitmap
var bmd = new bm_face(0, 0);
bm = new CastBitmap(bmd);
bm.id = "face";
bm.x = 100;
bm.y = 200;

で、とりあえずコンパイルしてみると”AboutScene”を表示させるタイミングでエラーが発生。

TypeError: Error #1009: null のオブジェクト参照のプロパティまたはメソッドにアクセスすることはできません。

さてこれは何が原因かいな？ということで、考えると”as CastMovieClip”はちと強引だったかしら？ということで、ライブラリの”div_scene1″のリンケージ設定で、基本ｸﾗｽを”jp.progression.casts.CastMovieClip”に設定。
これでOK。
さて続いて”AboutScene”で生成されて、”ContactScene”で削除される画像のオブジェクトの処理をするために”ContactScene”の中を設定。”_onInit”の中で

var bm:CastBitmap = getInstanceById("face") as CastBitmap;
if (bm)
{
progression.container.removeChild(bm);
}

としてコンパイル。
“AboutScne”を表示後、”ContactScene”を表示すると、きちんとbm(id=face)が削除される。
ここまではOK。
ただし、その後他のｼｰﾝに遷移してまた”ContactScene”に戻ったり、いきなり”ContactScene”に入ったり、用はCastBitmapオブジェクトが存在しない状態だとエラーが出る。

ArgumentError: Error #2025: 指定した DisplayObject は呼び出し元の子でなければなりません。

“if (bm)”では駄目っぽい。
ちと

var bm:CastBitmap = getInstanceById("face") as CastBitmap;

で何が戻ってきているのか？みてみると

[CastBitmap id=”face” name=”instance26″ group=”null”]

な感じ。addChildされているかどうか？は戻り値には関係ないっぽい。
ちなみに”getChildByName”だとremoveChildしたObjectは”null”で戻ってくる。
なので、addChildされているか否かを判定する必要がある・・。
さて・・・。ちょっとひとまずここで休憩。

ヨロヨロ進行中。
さて、ｼｰﾝの中に普通にMovieClipやら、イメージやらを貼り付けてみる。
SceneObjectは[SceneObject Inheritance →EventIntegrator Inheritance →flash.events.EventDispatcher]という継承なので、DisplayObjectでは無い。ここは一応注意。じゃあDisplayObjectは具体的にｼｰﾝごとに分離されているのか？と言われると多分違う。恐らくﾄﾞｷｭﾒﾝﾄﾙｰﾄにSceneに関係なく配置されているのだと思うが、Sceneをまたいで存在するDisplayObjectにどーアクセスするのか？はまだ分からない。
少し話しがそれたので、元に戻す。
ガイドに書いてあるaddCommandの形でとりあえずMovieClipとBitmapDataを貼り付けてみる。
ライブラリでMovieClipを”div_scene1″、JPG画像を”bm_face”でクラス定義。
Sceneのｺﾝｽﾄﾗｸﾀで

	public var mc1:MovieClip;
public var bm:Bitmap;
public function AboutScene( name:String = null, initObject:Object = null )
{
super( name, initObject );
page = new AboutPage();
mc1 = new div_scene1() as MovieClip;
var bmd = new bm_face(0, 0);
bm = new Bitmap(bmd);
bm.x = 100;
bm.y = 200;
}

こんな形で生成。
んでもって”_onInit”で

	addCommand(
new AddChild( progression.container, mc1),
new AddChild( progression.container, bm),
new AddChild( progression.container, page)
);

こんな感じでキャスト登録。
同様に”_onGoto”できちんと”RemoveChild”。

	addCommand(
new RemoveChild(progression.container, page),
new RemoveChild(progression.container, bm),
new RemoveChild(progression.container, mc1)
);

で、OK。
本当は用意されているjp.progression.casts Package – Progression 3.0 – API Referenceこの辺のキャスト系を使わないと、あまりAddCommandの中に入れている意味は無いのだと思うけど、まず整理の為に標準のやり方でやってみる。
次にaddCommandの中で定義しないで、直接貼ってみる。

Ver.2で途中まで手を付けたままで、なかなか先に進めずにいたprogression。
改めてVer.3で最初からやり直してみる。
同じタイミングでtrick7さんもスタートしている。trick7.com blog: やっと Progression3 をさわりはじめたメモ　多分こちらの方がヨタヨタ展開の予感。
まずprogression.jp | ドキュメント | クラス制作ガイドで一通り実装。色々基本的な項目がパッケージ化されていて便利。元のAS3を忘れそうで恐ろしいｗ
この時点での感想・疑問点としては

1. シーンが遷移中にボタンが自動的にKILLされている。これは便利な面もあれば不便な面もある。任意で解除できるのかは追って調べる。（ただ解除したらコマンド系非同期処理になにか破綻が出てくるかもしれない）
2. flashVarsにJSONを良く使用するのでindex.htmlにJSONを組み込みたいのだけど、テンプレートをどう修正すれば良いのか良く分からない（SWCの中？）。これも追って調べる。
3. データ構造がまだきちんと分かっていない。Indexの中のnew Progressionの第3引数でrootClass（ガイドではindexScene）を定義しているが、ここをnullにした場合どういう状態になるのか？(暗黙的にindex?)
4. IndexSceneの中で他のシーン(About,Contact)を生成している理由は？情報構造的にindexSceneの子供という考え方？
5. Sceneに複数のcastを割り振りできなくなった？（多分できるけど）

勉強会に行きたいのだけど、いつも都合が合わず欠席している。
次回こそなんとしても行きたい。