2014-06-09

UnityのWWW、WWWFormのハマりどころ

UnityにバンドルされているWWWクラスを使うと簡単にHTTP通信を行うことができて便利なのだけど、色々やろうとするといくつか判り難い挙動があったので、その辺りをメモ。

Unityのバージョンは4.5。

WWWのコンストラクタには下記の4つ（最後のものは非推奨）がある。ドキュメントはUnity - Scripting API: WWW.WWW。

WWW(string url);
WWW(string url, WWWForm form);
WWW(string url, byte[] postData);
WWW(string url, byte[] postData, Dictionary headers);
WWW(string url, byte[] postData, Hashtable headers); // deprecated

ここでまず気をつける必要があるのが、WWWFormクラスをそのまま渡す場合は、第三引数にHTTPヘッダを渡すことができない点。下記、ここから引き起こされるハマりどころ。

ファイル添付したらヘッダを追加できない？

WWWForm.AddBinaryData() を使うとファイルアップロードが可能だけど、HTTPヘッダも同時に変更したい場合に困ったことになる。

Dictionary<string, string> headers = new Dictionary<string, string>();
headers.Add("Cookie", "a=b");

WWForm form = new WWWForm();
form.AddBinaryData("foo", binary, "foo.png", "image/png");

WWW www = new WWW("http://example.com/", form.data, headers);

このようにすると正しくファイルアプロードができない。ここでHTTPヘッダを変更せずに WWW(string url, WWWForm form); コンストラクタを利用すると正しく動作するようになる。

WWForm form = new WWWForm();
form.AddBinaryData("foo", binary, "foo.png", "image/png");

WWW www = new WWW("http://example.com/", form);

ということは、コンストラクタの第二引数がformそのものではなくform.dataなのが駄目で、WWWFormインスタンスだから動作するのか、と結論付けてしまうとヘッダの変更ができなくなってしまう。

実際にはそうではなくて下記の挙動が考慮できていないことが原因。

WWW(string url, WWWForm form); コンストラクタを利用するとヘッダは内部でWWWForm.headersの値が利用される。
WWWForm.AddBinaryData() を呼び出すとWWWForm.headersにContent-Typeが自動的に追加される。
- 実際の値は multipart/form-data; boundary="xxxx"' という感じ

つまり、WWWForm.AddBinaryData() 後に追加されているContent-Typeヘッダの存在を無視して自前のヘッダのみを追加したことが原因なので、下記のようにWWWForm.headersを値を最後に設定するようにすれば動作するようになる。

Dictionary<string, string> headers = new Dictionary<string, string>();
headers.Add("Cookie", "a=b");

WWForm form = new WWWForm();
form.AddBinaryData("foo", binary, "foo.png", "image/png");

foreach (DictionaryEntry entry in form.headers)
{
    headers[System.Convert.ToString(entry.Key)] = System.Convert.ToString(entry.Value);
}

WWW www = new WWW("http://example.com/", form.data, headers);

GETだとHTTPヘッダを追加できない？

WWWクラスはコンストラクタ呼び出し時にWWWForm、もしくはpostDataが存在するとPOSTと解釈するようになっている。POSTの場合は単に第三引数にヘッダのDictionaryを渡せば良いが、GETの場合は適切なコンストラクタがない、ように見えるけれど、nullを渡せばGETでもヘッダを追加できる。

WWW www = new WWW("http://example.com/", null, headers);

POSTでpostDataがない場合はHTTPヘッダを追加できない？

応用編。POSTにも関わらず、POSTするデータはない。けれどもHTTPヘッダを追加したい。みたいな場合はどうしようもないので

form.AddField("dummy", "dummy");

とでもするしかないと思われる。postDataが空の場合は下記エラーになる。

Error when creating request. POST request with a zero-sized post buffer is not supported.

GET、POSTだけではなくPUT、DELETEも使いたい

使えない。上述のように、GETとPOSTが自動判定されるような機構で、PUT、DELETEはサポートされていない。

そういうわけでWWW用の便利なクラスを書いた

こういったハマりポイントを解決しつつ、もう少し楽にWWWとWWWFormを使いたいと思って、一つクラスを書いたのでGistに貼っておいた。

WWWClient.cs

特徴としては

コルーチンを使わないでコールバック（Delegate）で終了後の処理を書ける（内部ではコルーチンを使っている）
タイムアウトをサポート（地味に必要ですよね）
上述の複雑なコンストラクタのハマりどころをできるだけ解決

タイムアウトに関してはDEBUG.LOG (WWWクラスのタイムアウト処理)を参考にさせてもらいました。

使い方は下記な感じ。

using WWWKit;

public class WWWClientExample : MonoBehaviour
{
    void Start()
    {
        // 単純なGETリクエスト。終了処理はOnDoneプロパティにDelegateを代入。
        // DelegateにはおなじみのWWWクラスが渡されるのでレスポンスに関する
        // 処理は今まで通りWWWクラスのノウハウが利用可能。
        WWWClient client = new WWWClient(this, "http://example.com/");
        client.OnDone = (WWW www) => {
            Debug.Log(www.text);
        };
        client.Request();

        // POSTリクエストの場合は、WWWクラスの思想を継承して、下記のように
        // postDataを設定したらPOSTになる、という仕様。
        WWWClient http = new WWWClient(this, "http://example.com/");
        client.AddData("foo", "bar");
        client.OnDone = (WWW www) => {
            Debug.Log(www.text);
        };
        client.Request();

        // ファイル添付したい場合。下記はstringをbyte[]にしてるけど画像など
        // 何でも可能。
        byte[] binary = System.Text.Encoding.Unicode.GetBytes("bar");
        WWWClient http = new WWWClient(this, "http://example.com/");
        client.AddBinaryData("foo", binary, "test.txt", "application/octet-stream");
        client.OnDone = (WWW www) => {
            Debug.Log(www.text);
        };
        client.Request();

        // エラーハンドリングをする場合は、OnFailプロパティにDelegateを代入。
        // 正常終了のハンドリングと同じくWWWクラスが渡されるのでごにょごにょする。
        client.OnFail = (WWW www) => {
            Debug.Log(www.error);
        };

        // タイムアウトの場合はWWWクラスがDispose()された後で利用できなくなって
        // いるので、引数なしのDelegateをOnDisposedプロパティに代入する。
        client.OnDisposed = () => {
            Debug.Log("Timed out");
        };

        // タイムアウトを設定する場合はTimeoutプロパティに値を代入（float）。
        // デフォルトはタイムアウト設定なし（無制限）。
        client.Timeout = 10f;

        // ヘッダを追加する。
        client.AddHeader("Cookie", "cookiename=cookievalue");   
    }
}

2014-03-24

WebKitは欧文フォントによって和文フォントを切り替えている

知らなかった。CSSで和文フォントが指定されていない場合、ブラウザのデフォルト指定フォントで表示されるものだと思っていたけど、WebKit（Safari）やWebKitからフォークしたBlink（Chrome）では、欧文フォントによって和文フォントが切り替わるようになっているみたい。Safariは7.0.2、Chromeは33.0.1750.152で確認。

それぞれ和文フォントを指定していないのに欧文フォントの空気を読んで和文フォントまで明朝体、ゴシック体、ボールドに切り替わっている。ここに表示しているのは画像で実際のHTMLサンプルはこちら。

ただ、WindowsだとChromeでもこうならない。Linuxは未確認。

日本人が日本語のウェブサイトを作るときは日本語フォントを指定すると思うので気にするまでもないけど、最近Facebookのニュースフィードのシェアに明朝体が表示されるようになって、そういう趣味になったのかと思ってフォント指定を調べたら、欧文フォントしか指定されていなかったので、もしかしてと思ったらそうだった。

2014-02-13

SLAの稼働率がどのくらいのダウンタイムなのか計算するツール作った

稼働率 => 月間ダウンタイム計算ツール
http://cloned.jp/sla-calc/

ついでなので、有名どころのSLAを調べて載せたんだけど、Google App Engineの95.0％未満で50%返金や、Amazon EC2の 99.0％未満で30%返金みたいな返金レートは国産だと見つけられなかった。みんな10%で統一されていて15%というのが1件見つかったくらい。

そんなにたくさん調べていないのでざっと見た感じだけど、IDCフロンティアの稼働保証が 99.999% と高かった。

2013-12-22

topよりグラフィカルで操作性の良いhtopを使ってみた

htop - an interactive process-viewer for Linux

topに色を付けたいと思っていたらhtopというのがあったので使ってみた。SourceForgeに初めてコミットされたのが2006年3月4日となっていてそんなに新しいプロジェクトではないけれど、4日前にもコミットされていて、ちゃんとメンテされている模様。

Amazon Linuxだとyum リポジトリに入っているので下記だけでインストールできる。

$ sudo yum install htop

色が付いた以上に、CPUやメモリのグラフィカルな表示が可愛い！！

表示中のプロセスをスペースキーで選択状態にできて（画像だと黄色の行）、その場でF9を送信すると選択中のプロセスをkillできる強者。とはいえ、（プロセス番号ではなく）かなりカジュアルにkillできてしまうので本番で使うには恐いなーと思った。

操作性が良くて、表示されていない箇所は下にも上にもスクロールできて、プロセスの選択はマウスでポチっとできるし、各操作もキーバインドを覚える事無く明記されているファンクションキーから各操作ができる。上の画像はF6 SortByを選択したときのもの。topのキーバインドは全く覚えられなくて困る（hでヘルプ出せばわかるっちゃわかるけど）。

開発環境でしばらく使ってみよう。

2013-11-27

馨和 KAGUA Rouge Special Edition 2013を開栓

年の瀬になったら飲もうと心に決めていた馨和 KAGUA Rouge Special Edition 2013を開栓した。

「馨和 KAGUA」Rouge Special Edition 2013 posted by (C)cloned

そもそも馨和がどういうビールかについては、最近の記事だと横浜タカシマヤに日本クラフトビール「馨和 KAGUA」−限定試飲販売も - ヨコハマ経済新聞が適確に説明されていると思う。

7月に販売開始間もなく購入したので約4ヶ月寝かせてからの開栓。元々の馨和 Rougeがアルコール度数が9%なのに対してこれは11%なので、力強い味なのだろうという思い込みがあったためか、第一印象は「あっさり」だった。もちろん「薄い」という意味ではなく、Special Editionじゃない方と同じくらいの「あっさり」という意味である。

しかし、二口、三口と飲み進めるうちに「あぁ、丸いな」と感じるようになった。数ヶ月という若さにも関わらず「丸い」と感じられるのは非常に好印象だった。とはいえ、「ビールとして丸いか？」と問われれば「まだまだ生き生きとしている」と答えると思う。あくまでも元々の馨和 Rougeに比べて丸さを感じられるということであるし、繊細な炭酸が生き生きと感じされるのかもしれない。この辺はビールの状態（コンディション）に依るので、僕自身が飲んだ状態に依るのだけれど、こういう「ビールの状態」が存在するのも面白味の一つだろうか。

「馨和 KAGUA」Rouge Special Edition 2013 posted by (C)cloned

さて、話は変わってシリアルは3495だった。4000本の限定醸造で自分の瓶が何番なのか記載されている。特に3495という数字に意味はないけれども、4000本の中の1つをいただいている、というのも一つの楽しみになる。

この「馨和 KAGUA」Rouge Special Edition 2013はなんとまだ在庫があるらしい。750mlで3,045円。酒屋でシャンパンをカゴに入れる人にとってはそんなものかという値段だろうし、ビール1缶（350ml）200円と思う人にとっては高いと思う。このビールをどういうポジションと見るかによって高い安いの感覚は変わると思う。

馨和はとてもおすすめのビールだけど、Special Editionから入るよりは普通のバージョンを買ってみて好きかどうか試してみるのが良いと思う。

2013-11-23

関西ソーシャルゲーム勉強会でVPCとChefに関する発表をしてきました

第5回関西ソーシャルゲーム勉強会でAmazon VPCとChefに関する発表をしてきました。発表資料は以下のリンクからどうぞ。

小さく始めて後で困らないためのVPCとChefを使ったAWS運用

2013-10-20

ガチャみたいに設定した確率で抽選を行うPHPライブラリを作った

くじ引きやガチャガチャのように、あるものはよく出る、あるものはあまり出ない、というように確率に差がある上で一つ抽出する、というプログラムをたまに書くことがあるので、その部分だけを行うPHPライブラリを作った。

GitHub cloned/luckybox

インストール

Composerを使う場合は、composer.jsonのrequireに

"cloned/luckybox": "$VERSION"

を追加。$VERSIONに入れられるバージョンはPackagistを参照。今のところは 0.9.* としておくと良いでしょう。

Composer推奨だけど、Composerを使わない場合はGitHubからソースコードをダウンロードしてrequire_onceしてもOK。

使い方

コインは60%、キノコは35%、スターは5%、という設定で1回くじを引いてみる例はこんな感じ。

<?php
use LuckyBox\LuckyBox;
use LuckyBox\Card\IdCard;

// Items
$items = array(
    1 => array('name' => 'Coin',     'rate' => 60), // 60%
    2 => array('name' => 'Mushroom', 'rate' => 35), // 35%
    3 => array('name' => 'Star',     'rate' => 5),  //  5%
);

// Setup
$luckyBox = new LuckyBox();

foreach ($items as $id => $item) {
    $card = new IdCard();
    $card->setId($id)
         ->setRate($item['rate']);

    $luckyBox->add($card);
}

// Draw
$card = $luckyBox->draw();
$item = $items[$card->getId()];

echo "You got {$item['name']}" . PHP_EOL;

LuckyBoxに確率（rate）を設定したCardを詰めて、LuckyBox#draw()するとその確率に応じた割合で一つ取得できる。
バンドルされているIdCardクラスは、rate以外にidのみ保持できるクラスで、より複雑なCardを作りたい場合は、Cardインタフェースを実装したものであれば自作しても利用可能。

デフォルトでは無限に LuckyBox#draw() できるけれど、LuckyBox#setConsumable(true) するとadd()したCardの分しか引けなくなる。こんな感じで利用できる。

<?php
$luckyBox = new LuckyBox();

// Add some cards.

$luckyBox->setConsumable(true);

while (!$luckyBox->isEmpty()) {
    $card = $luckyBox->draw();

    // Do something.
}

0.5% みたいなより精度の高い確率を設定したい場合は、より大きな数をrateに設定すると可能。

<?php
$card1 = new IdCard();
$card2 = new IdCard();
$card1->setRate(1023); // 10.23%
$card2->setRate(8977); // 89.77%

ここでは説明しやすいように合計を100とか10000にしているけれど、実際には全てのrateの合計に対する比率になっているので、「1:1:3」みたいな指定も可能。「1:1:3」とすると「20%:20%:60%」という確率になる。

同じような要件があって、まだコーディングしていなければ、是非使ってみてください。