ionic-chromecast 0.0.3 → 0.0.5

package/README.md

@@ -8,6 +8,7 @@ A Capacitor plugin for integrating Google Cast SDK (Chromecast) with Ionic/Capac
 - ✅ Session management (request, check status)
 - ✅ Device discovery
 - ✅ Media playback with rich metadata
+- ✅ End active Cast session from app
 - ✅ Android support
 - ✅ Event listeners
 - 🚧 iOS support (coming soon)
@@ -41,7 +42,8 @@ import { IonicChromecast } from 'ionic-chromecast';
 // In your app.component.ts or main initialization
 async initializeCast() {
   const result = await IonicChromecast.initialize({
-    receiverApplicationId: 'CC1AD845' // Default Media Receiver
+    // Prefer CastVideos CAF receiver for reliable UI on TV. Use 'CC1AD845' if you need the default.
+    receiverApplicationId: '4F8B3483'
   });
   
   if (result.success) {
@@ -95,6 +97,14 @@ async playVideo() {
     console.log('▶️ Video is playing on TV!');
   }
 }
+
+// Optional: end the current Cast session from the app
+async stopCasting() {
+  const result = await IonicChromecast.endSession();
+  if (result.success) {
+    console.log('⏹ Cast session ended');
+  }
+}
 ```
 
 ## Complete Examples
@@ -275,6 +285,10 @@ export class CastControlPage implements OnDestroy {
     // Clean up listeners
     this.eventListeners.forEach(handle => handle.remove());
   }
+
+  async stopCast() {
+    await IonicChromecast.endSession();
+  }
 }
 ```
 
@@ -345,6 +359,7 @@ export class CastButtonComponent implements OnInit {
 * [`isSessionActive()`](#issessionactive)
 * [`areDevicesAvailable()`](#aredevicesavailable)
 * [`loadMedia(...)`](#loadmedia)
+* [`endSession()`](#endsession)
 * [`addListener(ChromecastEventType, ...)`](#addlistenerchromecasteventtype-)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
@@ -443,6 +458,19 @@ Load media on the Cast device (Android only)
 --------------------
 
 
+### endSession()
+
+```typescript
+endSession() => Promise<{ success: boolean; message?: string; }>
+```
+
+End the current Cast session (Android only)
+
+**Returns:** <code>Promise&lt;{ success: boolean; message?: string; }&gt;</code>
+
+--------------------
+
+
 ### addListener(ChromecastEventType, ...)
 
 ```typescript
@@ -538,3 +566,8 @@ Listen to Chromecast events (Android only)
 <code>'sessionStarted' | 'sessionEnded' | 'mediaLoaded' | 'mediaError' | 'deviceAvailable' | 'deviceUnavailable' | 'volumeChanged' | 'playbackStatusChanged'</code>
 
 </docgen-api>
+
+## Troubleshooting
+- No Cast UI on TV after connecting: use the CastVideos CAF receiver ID `4F8B3483` instead of the default `CC1AD845` when calling `initialize`.
+- Media returns success but nothing plays: confirm a session is active (`isSessionActive`), then retry `loadMedia` with a known-good HTTPS MP4 (e.g., BigBuckBunny).
+- Devices not found: ensure the phone and Chromecast are on the same WiFi and Google Play Services is up to date.

package/android/src/main/AndroidManifest.xml

@@ -4,6 +4,11 @@
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <uses-permission
+        android:name="android.permission.NEARBY_WIFI_DEVICES"
+        android:usesPermissionFlags="neverForLocation" />
     
     <application>
         <!-- Google Cast OptionsProvider -->

package/android/src/main/java/com/fabianacevedo/ionicchromecast/CastOptionsProvider.java

@@ -10,39 +10,38 @@ import java.util.List;
 
 /**
  * OptionsProvider for Google Cast SDK
- * This class is required by the Cast SDK to provide configuration options
  */
 public class CastOptionsProvider implements OptionsProvider {
-    
-    // Default Media Receiver App ID (Google's default receiver)
+
     private static final String DEFAULT_RECEIVER_APP_ID = "CC1AD845";
     private static final String PREFS_NAME = "IonicChromecastPrefs";
     private static final String KEY_RECEIVER_APP_ID = "receiverApplicationId";
-    
-    // Static variable to hold the receiver app ID before CastContext is initialized
+
     public static String sReceiverApplicationId = null;
-    
+
     @Override
     public CastOptions getCastOptions(Context context) {
         String receiverAppId = DEFAULT_RECEIVER_APP_ID;
-        
-        // Try to get from static variable first (set during initialize)
+
+        // Prefer static variable set by initialize()
         if (sReceiverApplicationId != null && !sReceiverApplicationId.isEmpty()) {
             receiverAppId = sReceiverApplicationId;
         } else {
-            // Fallback to SharedPreferences
+            // Try from SharedPreferences
             SharedPreferences prefs = context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE);
             String savedId = prefs.getString(KEY_RECEIVER_APP_ID, null);
             if (savedId != null && !savedId.isEmpty()) {
                 receiverAppId = savedId;
             }
         }
-        
+
         return new CastOptions.Builder()
             .setReceiverApplicationId(receiverAppId)
+            .setStopReceiverApplicationWhenEndingSession(true)
+            .setResumeSavedSession(false)
             .build();
     }
-    
+
     @Override
     public List<SessionProvider> getAdditionalSessionProviders(Context context) {
         return null;