NyARToolkit for Android demoのソースコードと使い方

NyARToolkit for Android のデモで紹介したAndroidアプリのソースコードと、その組み立て方を説明します。

準備

Android開発環境を事前にセットアップしてあるものとして説明します。API はAPI8を使えるようにしてください。

セットアップ

  1. 以下のURLから、ソースコードのセットをダウンロードします。
    andmmd-fileset-20120612
  2. Eclipseへ必要なプロジェクトをImportします。


    必要なのは次の4つです。

    • AndMmd – アプリケーションスケッチ本体
    • NyARToolkit for Android – AndUtils Android用のお道具箱
    • NyARToolkit for Android – NyARToolkit本体
    • NyMmdForAndroid – Android用のNyMmd

    NyMmc,NyMmdTest,src.pc.JOGLはPC用ですので、インポートするとエラーになります。

  3. もしかしたらエラーが発生するかもしれません。その時は文字コードをチェックしてください。NyMmd/NyARToolKitは、UTF-8で書かれています。

実行

通常のAndroidアプリケーションと同じように実行します。なお、実機/エミュレータでのデバック実行は、実行速度が1/100くらいになってしまうので、大変ストレス(起動まで1分くらい)があります。

Androidから直接起動すると、それなりの速度で動作します。

ライセンスについて

NyMmd(GPLv2)+NyARToolkit(GPLv3)のため、GPLv3となります。改造してアプリケーションを配布するときは、GPLの表示と、ソースコードの取得方法(問い合わせメールアドレスか、配布URLの表示)をお願いします。

English

This is explanation of how to make NyARToolkit for android demo program with NyMmd for Android.

Preparation

NyARToolkit for Android requires API8. Please prepare the development environment of API8 before setup.

Setup

  1. Download a fileset from below  URL. The file contains NyARToolkit, NyMmd and Application file.
    andmmd-fileset-20120612
  2. Import projects to Eclipse. Required projects are in list.
    • AndMmd – Application activity
    • NyARToolkit for Android – library
    • NyARToolkit for Android – NyARToolkit library
    • NyMmdForAndroid – NyMmd library
  3. If an error occurs, check  a character code is UTF-8.

Start Application

Start debug the AndMmd project.
In debug mode or an emulation, application is very a slow (100 times slower).
When it is started from Android, it runs at usual speed.