{"record":{"id":"71c6a0fc0f04e442","repo":"microg/GmsCore","slug":"failed-to-initialize-castcontext","errorCode":null,"errorMessage":"Failed to initialize CastContext.","messagePattern":"Failed to initialize CastContext\\.","errorType":"exception","errorClass":"IllegalStateException","httpStatus":null,"severity":"error","filePath":"play-services-cast-framework/src/main/java/com/google/android/gms/cast/framework/CastContext.java","lineNumber":183,"sourceCode":"                if (map.containsKey(sessionProvider.getCategory()))\n                    throw new IllegalArgumentException(\"SessionProvider for category \" + sessionProvider.getCategory() + \" already added\");\n                map.put(sessionProvider.getCategory(), sessionProvider.asBinder());\n            }\n        }\n        return map;\n    }\n\n    private static OptionsProvider getOptionsProvider(Context context) {\n        try {\n            Bundle metaData = context.getPackageManager().getApplicationInfo(context.getPackageName(), PackageManager.GET_META_DATA).metaData;\n            String optionsProviderClassName = metaData.getString(OPTIONS_PROVIDER_CLASS_NAME_KEY);\n            if (optionsProviderClassName != null) {\n                return Class.forName(optionsProviderClassName).asSubclass(OptionsProvider.class).getDeclaredConstructor().newInstance();\n            }\n            throw new IllegalStateException(\"The fully qualified name of the implementation of OptionsProvider must be provided as a metadata in the AndroidManifest.xml with key com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME.\");\n        } catch (PackageManager.NameNotFoundException | ClassNotFoundException | NoSuchMethodException | IllegalAccessException | InstantiationException |\n                 InvocationTargetException | NullPointerException e) {\n            throw new IllegalStateException(\"Failed to initialize CastContext.\", e);\n        }\n    }\n\n    @NonNull\n    DiscoveryManager getDiscoveryManager() {\n        return discoveryManager;\n    }\n}\n","sourceCodeStart":165,"sourceCodeEnd":192,"githubUrl":"https://github.com/microg/GmsCore/blob/157c9d86ac46c195a86c2f15ab55c84036223f95/play-services-cast-framework/src/main/java/com/google/android/gms/cast/framework/CastContext.java#L165-L192","documentation":"Wraps failure in CastContext.getOptionsProvider: the OPTIONS_PROVIDER_CLASS_NAME metadata could not be read from the app manifest or the named provider class could not be instantiated, so CastOptions cannot be obtained during CastContext creation.","triggerScenarios":"Thrown at play-services-cast-framework/src/main/java/com/google/android/gms/cast/framework/CastContext.java:183 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify the OPTIONS_PROVIDER_CLASS_NAME metadata value matches a real, public, no-arg-instantiable class","Ensure the class implements CastContext.OptionsProvider","Catch the IllegalStateException and run without cast options"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"157c9d86ac46c195a86c2f15ab55c84036223f95","analyzedAt":"2026-09-06T17:27:33.892Z","contentChangedAt":"2026-09-06T17:27:33.892Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}