Spotify Android SDK授权仅在Spotify应用活跃时生效问题求助

核心问题原因 #

Android 14引入了后台启动Activity的严格限制：当Spotify应用未处于前台时，Spotify SDK尝试启动授权视图属于后台启动操作，会被系统拦截，导致授权弹窗无法弹出，且onConnected/onFailure回调无响应。同时Android 14要求后台交互必须持有POST_NOTIFICATIONS权限，否则相关操作会被阻断。

解决方案步骤 #

1. 声明必要权限

在AndroidManifest.xml中添加以下权限：

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.INTERNET" />

2. 动态请求通知权限

在Activity中动态申请Android 14要求的通知权限：

private fun checkNotificationPermission() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.POST_NOTIFICATIONS) 
            != PackageManager.PERMISSION_GRANTED) {
            requestPermissions(arrayOf(Manifest.permission.POST_NOTIFICATIONS), 1001)
        }
    }
}

3. 连接前确保Spotify处于前台

添加工具方法检查Spotify是否安装，并在未运行时先启动它，延迟后再发起连接：

// 检查Spotify是否已安装
private fun isSpotifyInstalled(): Boolean {
    val pm = packageManager
    return try {
        pm.getPackageInfo("com.spotify.music", PackageManager.GET_ACTIVITIES)
        true
    } catch (e: PackageManager.NameNotFoundException) {
        false
    }
}

// 启动Spotify并延迟发起连接
private fun launchSpotifyIfNeeded() {
    if (!isSpotifyInstalled()) {
        Toast.makeText(this, "请先安装Spotify应用", Toast.LENGTH_SHORT).show()
        return
    }
    val intent = packageManager.getLaunchIntentForPackage("com.spotify.music")
    intent?.let {
        startActivity(it)
        // 延迟1秒让Spotify进入前台后再连接
        Handler(Looper.getMainLooper()).postDelayed({
            connectToSpotify()
        }, 1000)
    }
}

// 抽离原连接逻辑为独立方法
private fun connectToSpotify() {
    val connectionParams = ConnectionParams.Builder(client_id)
        .setRedirectUri(resources.getString(redirect_uri))
        .showAuthView(true)
        .build()

    SpotifyAppRemote.connect(this, connectionParams,
        object : Connector.ConnectionListener {
            override fun onConnected(appRemote: SpotifyAppRemote) {
                spotifyAppRemote = appRemote
                Log.d("Spotify", "Connected! Yay!")
            }

            override fun onFailure(throwable: Throwable) {
                Log.e("Spotify", "Failed to connect to Spotify: $throwable")
            }
        }
    )
}

4. 修改onStart方法逻辑

将原连接逻辑替换为权限检查+启动Spotify+连接的流程：

override fun onStart() {
    super.onStart()
    checkNotificationPermission()
    launchSpotifyIfNeeded()
}

5. 确认Redirect Uri配置正确

确保Spotify开发者后台配置的Redirect Uri与代码中一致，并在AndroidManifest.xml中注册对应的回调Activity：

<activity
    android:name=".SpotifyCallbackActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- 替换为你的Redirect Uri Scheme -->
        <data android:scheme="your-app-scheme" />
    </intent-filter>
</activity>

关键说明 #

• 先启动Spotify到前台，能让授权视图在前台环境下正常触发，规避Android 14的后台启动限制。
• POST_NOTIFICATIONS权限是Android 14中后台交互的必要条件，缺失会导致SDK无法正常触发授权流程。

内容的提问来源于stack exchange，提问作者M.X