Android / iOS 接入说明

// app/build.gradle.kts
dependencies {
    implementation("com.android.installreferrer:installreferrer:2.2")
}

<!-- AndroidManifest.xml -->
<activity
    android:name=".MainActivity"
    android:exported="true"
    android:launchMode="singleTask">

    <!-- 已安装 App：接收 App Link -->
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="https" android:host="loop.pepstar.tw" android:pathPrefix="/f/" />
        <data android:scheme="https" android:host="loop.pepstar.tw" android:pathPrefix="/g/" />
    </intent-filter>

    <!-- 兼容当前网页使用的自定义 Scheme，例如 pepstar://guild/10001 -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="${HANDOFF_SCHEME}" />
    </intent-filter>
</activity>

data class HandoffSeed(
    val linkType: String,
    val clickId: String?,
    val shortCode: String,
    val platformCode: String,
    val packageName: String
)

fun Uri.toHandoffSeed(platformCode: String, packageName: String): HandoffSeed? {
    val firstPath = pathSegments.firstOrNull()?.lowercase()
    val linkType = getQueryParameter("gl_link_type")
        ?: getQueryParameter("link_type")
        ?: if (host == "guild" || firstPath == "g") "guild" else "flow"
    val shortCode = getQueryParameter("gl_short_code")
        ?: getQueryParameter("short_code")
        ?: getQueryParameter("code")
        ?: pathSegments.lastOrNull()
        ?: return null

    return HandoffSeed(
        linkType = linkType,
        clickId = getQueryParameter("gl_click_id") ?: getQueryParameter("click_id"),
        shortCode = shortCode.uppercase(),
        platformCode = getQueryParameter("gl_platform_code") ?: platformCode,
        packageName = getQueryParameter("gl_package_name") ?: packageName
    )
}

class GuildLoopInstallReferrer(
    private val context: Context,
    private val onSeed: (HandoffSeed) -> Unit
) : InstallReferrerStateListener {
    private val client = InstallReferrerClient.newBuilder(context).build()
    private val prefs = context.getSharedPreferences("guildloop_handoff", Context.MODE_PRIVATE)

    fun start() {
        if (prefs.getBoolean("install_referrer_resolved", false)) return
        client.startConnection(this)
    }

    override fun onInstallReferrerSetupFinished(code: Int) {
        if (code != InstallReferrerClient.InstallReferrerResponse.OK) {
            client.endConnection() // 网络或 Play 服务恢复后重试
            return
        }
        try {
            val raw = client.installReferrer.installReferrer
            val uri = Uri.parse("https://referrer.local/?" + raw)
            uri.toHandoffSeed(BuildConfig.PLATFORM_CODE, context.packageName)?.let(onSeed)
            // first-open API 成功后再写 true；不要在网络失败时永久丢弃
        } finally {
            client.endConnection()
        }
    }

    override fun onInstallReferrerServiceDisconnected() = Unit

    fun markResolved() {
        prefs.edit().putBoolean("install_referrer_resolved", true).apply()
    }
}

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        handleHandoff(intent)
        GuildLoopInstallReferrer(this) { seed -> resolveAndRoute(seed) }.start()
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        setIntent(intent)
        handleHandoff(intent)
    }

    private fun handleHandoff(intent: Intent?) {
        val seed = intent?.data?.toHandoffSeed(BuildConfig.PLATFORM_CODE, packageName) ?: return
        resolveAndRoute(seed)
    }

    private fun resolveAndRoute(seed: HandoffSeed) {
        // 调用下方 first-open API；成功后只按 response.context 导航
        HandoffApi.resolve(seed, BuildConfig.VERSION_NAME, InstallId.get(this)) { context ->
            when (context.linkType) {
                "guild" -> GuildNavigator.open(context.guildId, context.roomId)
                "flow" -> DestinationNavigator.open(context.destinationType, context.destinationExternalId)
            }
        }
    }
}

object HandoffApi {
    private const val ENDPOINT =
        "https://loop.pepstar.tw/api/v1/public/app-handoff/first-open"

    // 必须从 IO 线程/协程调用；这里使用 JDK 网络类，避免绑定具体 HTTP SDK。
    fun resolveBlocking(seed: HandoffSeed, version: String, installId: String): JSONObject {
        val body = JSONObject()
            .put("link_type", seed.linkType)
            .put("click_id", seed.clickId ?: "")
            .put("short_code", seed.shortCode)
            .put("platform_code", seed.platformCode)
            .put("package_name", seed.packageName)
            .put("client_os", "android")
            .put("device_id", installId)
            .put("app_version", version)

        val connection = URL(ENDPOINT).openConnection() as HttpURLConnection
        connection.requestMethod = "POST"
        connection.connectTimeout = 10_000
        connection.readTimeout = 10_000
        connection.setRequestProperty("Content-Type", "application/json")
        connection.doOutput = true
        connection.outputStream.use { it.write(body.toString().toByteArray(Charsets.UTF_8)) }

        val stream = if (connection.responseCode in 200..299) {
            connection.inputStream
        } else {
            throw IOException("first-open HTTP " + connection.responseCode)
        }
        return stream.bufferedReader().use { JSONObject(it.readText()) }
    }
}