AndroidがOSを卒業した日 — AppFunctions APIで壁紙アプリをGemini Intelligenceにつないだ実装記録

// build.gradle.kts（app モジュール）
dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha01")
    implementation("com.google.firebase:firebase-ai:25.0.0")
    kapt("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01")
}

// WallpaperAppFunctions.kt
import androidx.appfunctions.AppFunction
import androidx.appfunctions.AppFunctionContext
import androidx.appfunctions.AppFunctionResult
 
@AppFunction(
    id = "com.example.wallpaper.SET_WALLPAPER_BY_MOOD",
    description = "Set device wallpaper based on user's current mood or preference. " +
        "Supports moods like 'calm', 'energetic', 'nature', 'minimal', and 'seasonal'. " +
        "Use this when the user wants to change their wallpaper based on how they feel.",
    parameters = [
        AppFunction.Parameter(
            name = "mood",
            description = "The mood or theme for wallpaper selection. " +
                "Examples: calm, nature, minimal, energetic, space, warm, seasonal",
            type = String::class
        ),
        AppFunction.Parameter(
            name = "setImmediately",
            description = "Whether to apply the wallpaper right away (true) " +
                "or show a preview screen first (false). Default is false.",
            type = Boolean::class,
            required = false
        )
    ]
)
class SetWallpaperByMoodFunction(
    private val wallpaperRepository: WallpaperRepository,
    private val wallpaperManager: WallpaperManager
) : AppFunction {
 
    override suspend fun execute(
        context: AppFunctionContext,
        parameters: Map<String, Any?>
    ): AppFunctionResult {
        val mood = parameters["mood"] as? String
            ?: return AppFunctionResult.error("mood parameter is required")
        val setImmediately = parameters["setImmediately"] as? Boolean ?: false
 
        // 気分に合う壁紙をリポジトリから取得
        val wallpaper = wallpaperRepository.findByMood(mood)
            ?: return AppFunctionResult.error("「${mood}」に合う壁紙が見つかりませんでした")
 
        return if (setImmediately) {
            // 即時適用
            wallpaperManager.setWallpaper(wallpaper.bitmap)
            AppFunctionResult.success(
                message = "壁紙を「${wallpaper.title}」（${mood}テーマ）に変更しました",
                data = mapOf("wallpaperId" to wallpaper.id, "title" to wallpaper.title)
            )
        } else {
            // プレビュー画面への遷移
            AppFunctionResult.deepLink(
                uri = "wallpaperapp://preview/${wallpaper.id}",
                message = "「${wallpaper.title}」のプレビューを開きます"
            )
        }
    }
}

<!-- AndroidManifest.xml -->
<application>
    <meta-data
        android:name="androidx.appfunctions.APP_FUNCTIONS"
        android:resource="@xml/app_functions" />
</application>

<!-- res/xml/app_functions.xml -->
<app-functions>
    <app-function
        android:id="com.example.wallpaper.SET_WALLPAPER_BY_MOOD"
        android:enabled="true"
        android:allowedCallers="com.google.android.apps.assistant" />
</app-functions>

// AIWallpaperAdvisor.kt
import com.google.firebase.ai.FirebaseAI
import com.google.firebase.ai.GenerativeModel
import com.google.firebase.ai.type.GenerationConfig
import com.google.firebase.ai.type.content
 
class AIWallpaperAdvisor {
 
    private val model: GenerativeModel by lazy {
        FirebaseAI.getInstance().generativeModel(
            modelName = "gemini-2.5-pro",
            generationConfig = GenerationConfig.builder()
                .maxOutputTokens(512)
                .temperature(0.4f)  // 壁紙提案は低めの温度で安定した回答を得る
                .build(),
            systemInstruction = content {
                text(
                    """
                    あなたは壁紙アプリのAIアドバイザーです。
                    ユーザーの気分・時間帯・天気をもとに、
                    おすすめの壁紙カテゴリと設定理由を提案してください。
                    回答は必ず日本語で、2文以内に簡潔にまとめてください。
                    カテゴリ候補: nature, minimal, space, warm, cool, abstract, city, art, seasonal
                    """.trimIndent()
                )
            }
        )
    }
 
    // 気分・時間帯からカテゴリ推薦
    suspend fun recommendCategory(
        mood: String,
        timeOfDay: String,
        weather: String = "不明"
    ): RecommendationResult {
        return try {
            val prompt = buildString {
                append("現在の気分: $mood\n")
                append("時間帯: $timeOfDay\n")
                append("天気: $weather\n")
                append("この状況に最もふさわしい壁紙カテゴリを1つ選び、理由を1文で説明してください。")
                append("形式: カテゴリ名|理由")
            }
 
            val response = model.generateContent(content { text(prompt) })
            val text = response.text?.trim() ?: return RecommendationResult.Fallback
 
            val parts = text.split("|")
            if (parts.size >= 2) {
                RecommendationResult.Success(
                    category = parts[0].trim(),
                    reason = parts[1].trim()
                )
            } else {
                RecommendationResult.Fallback
            }
        } catch (e: Exception) {
            RecommendationResult.Fallback
        }
    }
}
 
sealed class RecommendationResult {
    data class Success(val category: String, val reason: String) : RecommendationResult()
    object Fallback : RecommendationResult()
}

# AGENTS.md（Android Intelligence System対応プロジェクト用）
 
## プロジェクトの目的
壁紙アプリにGemini Intelligence対応を追加する。
AppFunctions APIを用い、ユーザーが自然言語で壁紙を操作できるようにする。
 
## 技術スタック
- Android 17 / Kotlin 2.x / Jetpack Compose
- AppFunctions API alpha（androidx.appfunctions:1.0.0-alpha01）
- Firebase AI Logic SDK（Gemini 2.5 Pro）
- EAP段階のAPIのため、公式ドキュメントはgoo.gle/eap-af参照
 
## AppFunctions 設計原則
- description と parameter説明は英語で記述（Geminiの理解精度が高い）
- parameter の description に必ず具体的な値の例を含める
- エラーメッセージと success.message は日本語（エンドユーザー向け）
- setImmediately のデフォルト値は false にする（壁紙の誤適用防止）
- deepLinkはプレビュー遷移にのみ使用し、確認不要なアクションは直接実行する
 
## Firebase AI Logic の原則
- temperature は 0.3〜0.5 の範囲で設定する（ユーティリティアプリのため）
- systemInstruction で必ず返答の文字数・言語・フォーマットを指定する
- レスポンステキストはUIに表示する前にtrim()とサニタイズを行う
 
## 既知の制約（2026-05-14時点）
- AppFunctions はAndroid 17以上でのみ動作確認済み
- allowedCallers は現在 com.google.android.apps.assistant のみ
- EAP登録URL: goo.gle/eap-af

// AppFunctionsテスト（Antigravity AgentKit連携想定）
@Test
fun `気分がcalmのとき適切な壁紙が選ばれること`() = runTest {
    // Given
    val mockRepo = mockk<WallpaperRepository> {
        coEvery { findByMood("calm") } returns WallpaperFixtures.calmWallpaper
    }
    val function = SetWallpaperByMoodFunction(mockRepo, mockk(relaxed = true))
 
    // When
    val result = function.execute(
        context = AppFunctionContext.forTest(),
        parameters = mapOf("mood" to "calm", "setImmediately" to true)
    )
 
    // Then
    assertThat(result).isInstanceOf(AppFunctionResult.Success::class.java)
    assertThat((result as AppFunctionResult.Success).message).contains("calm")
}