轻松接入
极速畅玩

// MigoGameView.java 文档用法
MigoGameView gameView = new MigoGameView(context);

RuntimeConfig config = new RuntimeConfig.Builder(context)
    .setImmersiveMode(false)   // 嵌入式视图通常为 false
    .setTargetFps(60)
    .setCodeCacheDir(cacheDir)
    // 适配层就是一段前置脚本，多次调用按顺序累加
    .addPreludeScript("<migo-web-adapter>", adapterSource)
    .build();

gameView.setConfig(config);
gameView.setGameListener(listener);
layout.addView(gameView);
gameView.loadGame("my-game", "game.js");

RuntimeConfig 另可钉住启动方向、日志级别、看门狗超时与代码签名校验。前置脚本名会出现在 V8 调用栈里，便于区分适配层报错与游戏报错。

// iOS — MigoGameView, UIKit (SwiftUI 经 UIViewRepresentable)
import MigoApplePerformancePlus

let config = try MigoGameView.Configuration.standard(contentSigning: .unsigned)
try MigoGameInstaller.install(package: gameDir, id: "my-game",
                              version: build, into: config.directories)

let gameView = MigoGameView(configuration: config)
gameView.onEvent = { event in /* .ready, .exitRequested, … */ }
parent.addSubview(gameView)
gameView.loadGame(id: "my-game")

SwiftPM 包 migo-<版本>-apple-sdk.zip, iOS 15.2+。内容 JS 跑在 WebKit 的 JavaScriptCore(带 JIT), 渲染由 Migo 在 App 进程完成(Performance+)。

// macOS — 同一个包, AppKit
import MigoMacV8

let config = try MigoGameView.Configuration.standard(contentSigning: .unsigned)
try MigoGameInstaller.install(package: gameDir, id: "my-game",
                              version: build, into: config.directories)

let gameView = MigoGameView(configuration: config)
window.contentView = gameView
gameView.loadGame(id: "my-game")

macOS 11+, V8 带 JIT 在本进程运行。App 需以 hardened runtime + allow-jit 签名, 并在构建阶段嵌入 ANGLE。

// Linux — C ABI, 挂在宿主 UI 拥有的窗口上
#include <migo/migo.h>
#include <migo/platform/x11.h>

migo_engine_create(&engine_config, &engine);
migo_session_create(engine, &session_config, &session);
migo_session_set_host_callbacks(session, &callbacks);

MigoX11WindowDescriptor x11 = { /* … */ .display = dpy, .window = xid };
migo_session_attach_surface(session, &surface, &attachment);
migo_session_load_content(session, &content);  /* my-game, game.js */

C ABI 为候选版, 尚未冻结。宿主提供 X11 或 Wayland 窗口, 用 migo_session_notify_vsync 驱动出帧; host-kit 里有 Qt 6 / X11 适配器。

// Windows — C ABI, 挂在宿主拥有的子 HWND 上
#include <migo/migo.h>
#include <migo/platform/win32.h>

migo_engine_create(&engine_config, &engine);
migo_session_create(engine, &session_config, &session);
migo_session_set_host_callbacks(session, &callbacks);

MigoWin32HwndDescriptor win = { /* … */ .hwnd = child_hwnd };
migo_session_attach_surface(session, &surface, &attachment);
migo_session_load_content(session, &content);  /* my-game, game.js */

migo.dll + 导入库与 CMake target, x64 / arm64。渲染经 ANGLE 画到 HWND 上; WinUI 集成由宿主完成。

// OpenHarmony — XComponent 绑定 native 宿主模块
XComponent({ id: 'migo_surface', type: XComponentType.SURFACE,
             libraryname: 'migohost' })
  .onLoad(() => {
    // native 侧经同一套 C ABI 挂载 surface
    migohost.start(filesDir, cacheDir, 'my-game', scaleFactor);
  })

完整 DevEco 宿主工程。HarmonyOS NEXT 不允许第三方 JIT, 那里 V8 以 jitless 运行。

// 商业化与账号留在宿主：游戏只发起，宿主决定怎么实现
class Ads   implements AdHandler         { /* 接你自己的聚合 SDK */ }
class Auth  implements AuthHandler       { /* 接你自己的账号服务 */ }
class Pay   implements PaymentHandler    { /* 接你自己的支付通道 */ }
class Perms implements PermissionHandler { /* 你决定游戏能用什么 */ }
class Sink  implements AdEventSink       { /* 曝光 / 点击 / 完播回传 */ }

// 游戏里调 createRewardedVideoAd()  -> 走到 AdHandler
// 游戏里调 login()                  -> 走到 AuthHandler
// 游戏里调 requestMidasPayment()    -> 走到 PaymentHandler
// 一个都不接也能跑，只是这些调用会明确失败

运行时不内置任何广告网络，也不持有账号体系。收款和登录都发生在你的 SDK 里。