ionic-chromecast 0.0.1

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

@@ -0,0 +1,184 @@
+package com.fabianacevedo.ionicchromecast;
+
+import android.content.Context;
+import com.getcapacitor.Logger;
+import com.google.android.gms.cast.framework.CastContext;
+import com.google.android.gms.cast.framework.CastOptions;
+import com.google.android.gms.cast.framework.OptionsProvider;
+import com.google.android.gms.cast.framework.SessionProvider;
+import com.google.android.gms.cast.CastMediaControlIntent;
+import java.util.List;
+
+public class IonicChromecast {
+    
+    private static final String TAG = "IonicChromecast";
+    private CastContext castContext;
+    private boolean isInitialized = false;
+    
+    /**
+     * Initialize the Google Cast SDK with the provided receiver application ID
+     * @param context The application context
+     * @param receiverApplicationId The Cast receiver application ID
+     * @return true if initialization was successful
+     */
+    public boolean initialize(Context context, String receiverApplicationId) {
+        try {
+            if (isInitialized) {
+                Logger.info(TAG, "Cast SDK already initialized");
+                return true;
+            }
+            
+            if (receiverApplicationId == null || receiverApplicationId.isEmpty()) {
+                Logger.error(TAG, "Receiver Application ID is required");
+                return false;
+            }
+            
+            Logger.info(TAG, "Initializing Cast SDK with receiver ID: " + receiverApplicationId);
+            
+            // Initialize CastContext
+            castContext = CastContext.getSharedInstance(context);
+            
+            if (castContext != null) {
+                isInitialized = true;
+                Logger.info(TAG, "Cast SDK initialized successfully");
+                return true;
+            } else {
+                Logger.error(TAG, "Failed to get CastContext");
+                return false;
+            }
+            
+        } catch (Exception e) {
+            Logger.error(TAG, "Error initializing Cast SDK: " + e.getMessage(), e);
+            return false;
+        }
+    }
+    
+    /**
+     * Check if the Cast SDK is initialized
+     * @return true if initialized
+     */
+    public boolean isInitialized() {
+        return isInitialized;
+    }
+    
+    /**
+     * Get the CastContext instance
+     * @return CastContext or null if not initialized
+     */
+    public CastContext getCastContext() {
+        return castContext;
+    }
+
+    public String echo(String value) {
+        Logger.info("Echo", value);
+        return value;
+    }
+    
+    /**
+     * Request a Cast session
+     * Shows the Cast dialog and starts a session if a device is selected
+     * @param context The application context
+     * @return true if session started, false otherwise
+     */
+    public boolean requestSession(Context context) {
+        if (!isInitialized || castContext == null) {
+            Logger.error(TAG, "Cast SDK not initialized. Call initialize() first.");
+            return false;
+        }
+        try {
+            // Show the Cast dialog
+            castContext.getSessionManager().startSession(false);
+            Logger.info(TAG, "Requested Cast session (dialog should appear)");
+            return true;
+        } catch (Exception e) {
+            Logger.error(TAG, "Error requesting Cast session: " + e.getMessage(), e);
+            return false;
+        }
+    }
+    
+    /**
+     * Check if there is an active Cast session
+     * @return true if session is active, false otherwise
+     */
+    public boolean isSessionActive() {
+        if (!isInitialized || castContext == null) {
+            Logger.error(TAG, "Cast SDK not initialized. Call initialize() first.");
+            return false;
+        }
+        try {
+            boolean active = castContext.getSessionManager().getCurrentCastSession() != null;
+            Logger.info(TAG, "Session active: " + active);
+            return active;
+        } catch (Exception e) {
+            Logger.error(TAG, "Error checking session status: " + e.getMessage(), e);
+            return false;
+        }
+    }
+    
+    /**
+     * Check if there are available Cast devices
+     * @return true if devices are available, false otherwise
+     */
+    public boolean areDevicesAvailable() {
+        if (!isInitialized || castContext == null) {
+            Logger.error(TAG, "Cast SDK not initialized. Call initialize() first.");
+            return false;
+        }
+        try {
+            // Check if there are any Cast devices discovered
+            int deviceCount = castContext.getDiscoveryManager().getCastDeviceCount();
+            boolean available = deviceCount > 0;
+            Logger.info(TAG, "Devices available: " + available + " (" + deviceCount + ")");
+            return available;
+        } catch (Exception e) {
+            Logger.error(TAG, "Error checking device availability: " + e.getMessage(), e);
+            return false;
+        }
+    }
+    
+    /**
+     * Load media on the Cast device
+     * @param url The media URL
+     * @param metadata Optional metadata (title, images, etc)
+     * @return true if media loaded successfully
+     */
+    public boolean loadMedia(String url, MediaMetadataCompat metadata) {
+        if (!isInitialized || castContext == null) {
+            Logger.error(TAG, "Cast SDK not initialized. Call initialize() first.");
+            return false;
+        }
+        try {
+            if (url == null || url.isEmpty()) {
+                Logger.error(TAG, "Media URL is required");
+                return false;
+            }
+            // Build Cast media info
+            com.google.android.gms.cast.MediaMetadata castMetadata = new com.google.android.gms.cast.MediaMetadata(com.google.android.gms.cast.MediaMetadata.MEDIA_TYPE_MOVIE);
+            if (metadata != null) {
+                if (metadata.getString(MediaMetadataCompat.METADATA_KEY_TITLE) != null)
+                    castMetadata.putString(com.google.android.gms.cast.MediaMetadata.KEY_TITLE, metadata.getString(MediaMetadataCompat.METADATA_KEY_TITLE));
+                if (metadata.getString(MediaMetadataCompat.METADATA_KEY_ARTIST) != null)
+                    castMetadata.putString(com.google.android.gms.cast.MediaMetadata.KEY_SUBTITLE, metadata.getString(MediaMetadataCompat.METADATA_KEY_ARTIST));
+                if (metadata.getString(MediaMetadataCompat.METADATA_KEY_ALBUM_ART_URI) != null)
+                    castMetadata.addImage(new com.google.android.gms.cast.Image(android.net.Uri.parse(metadata.getString(MediaMetadataCompat.METADATA_KEY_ALBUM_ART_URI))));
+                // Add more metadata fields as needed
+            }
+            com.google.android.gms.cast.MediaInfo mediaInfo = new com.google.android.gms.cast.MediaInfo.Builder(url)
+                .setStreamType(com.google.android.gms.cast.MediaInfo.STREAM_TYPE_BUFFERED)
+                .setContentType(metadata != null && metadata.getString(MediaMetadataCompat.METADATA_KEY_MEDIA_URI) != null ? metadata.getString(MediaMetadataCompat.METADATA_KEY_MEDIA_URI) : "video/mp4")
+                .setMetadata(castMetadata)
+                .build();
+            com.google.android.gms.cast.framework.CastSession session = castContext.getSessionManager().getCurrentCastSession();
+            if (session == null || !session.isConnected()) {
+                Logger.error(TAG, "No active Cast session");
+                return false;
+            }
+            session.getRemoteMediaClient().load(mediaInfo, true, 0);
+            Logger.info(TAG, "Media loaded to Cast device: " + url);
+            return true;
+        } catch (Exception e) {
+            Logger.error(TAG, "Error loading media: " + e.getMessage(), e);
+            return false;
+        }
+    }
+}

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

@@ -0,0 +1,131 @@
+package com.fabianacevedo.ionicchromecast;
+
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import androidx.media.MediaMetadataCompat;
+
+@CapacitorPlugin(name = "IonicChromecast")
+public class IonicChromecastPlugin extends Plugin {
+
+    private IonicChromecast implementation = new IonicChromecast();
+
+    /**
+     * Initialize the Google Cast SDK
+     * This method must be called before using any other Cast functionality
+     */
+    @PluginMethod
+    public void initialize(PluginCall call) {
+        String receiverApplicationId = call.getString("receiverApplicationId");
+        
+        if (receiverApplicationId == null || receiverApplicationId.isEmpty()) {
+            call.reject("Receiver Application ID is required");
+            return;
+        }
+        
+        boolean success = implementation.initialize(getContext(), receiverApplicationId);
+        
+        JSObject ret = new JSObject();
+        ret.put("success", success);
+        
+        if (success) {
+            call.resolve(ret);
+        } else {
+            call.reject("Failed to initialize Cast SDK", ret);
+        }
+    }
+
+    @PluginMethod
+    public void echo(PluginCall call) {
+        String value = call.getString("value");
+
+        JSObject ret = new JSObject();
+        ret.put("value", implementation.echo(value));
+        call.resolve(ret);
+    }
+
+    /**
+     * Request a Cast session from JavaScript
+     */
+    @PluginMethod
+    public void requestSession(PluginCall call) {
+        boolean success = implementation.requestSession(getContext());
+        JSObject ret = new JSObject();
+        ret.put("success", success);
+        if (success) {
+            ret.put("message", "Cast session requested. Dialog should appear.");
+            call.resolve(ret);
+        } else {
+            ret.put("message", "Failed to request Cast session. Make sure SDK is initialized.");
+            call.reject("Failed to request Cast session", ret);
+        }
+    }
+
+    /**
+     * Check if there is an active Cast session from JavaScript
+     */
+    @PluginMethod
+    public void isSessionActive(PluginCall call) {
+        boolean active = implementation.isSessionActive();
+        JSObject ret = new JSObject();
+        ret.put("active", active);
+        if (active) {
+            ret.put("message", "There is an active Cast session.");
+        } else {
+            ret.put("message", "No active Cast session.");
+        }
+        call.resolve(ret);
+    }
+
+    /**
+     * Check if there are available Cast devices from JavaScript
+     */
+    @PluginMethod
+    public void areDevicesAvailable(PluginCall call) {
+        boolean available = implementation.areDevicesAvailable();
+        JSObject ret = new JSObject();
+        ret.put("available", available);
+        if (available) {
+            ret.put("message", "There are Cast devices available.");
+        } else {
+            ret.put("message", "No Cast devices available.");
+        }
+        call.resolve(ret);
+    }
+
+    /**
+     * Load media on the Cast device from JavaScript
+     */
+    @PluginMethod
+    public void loadMedia(PluginCall call) {
+        String url = call.getString("url");
+        JSObject metadataObj = call.getObject("metadata");
+        MediaMetadataCompat metadata = null;
+        if (metadataObj != null) {
+            MediaMetadataCompat.Builder builder = new MediaMetadataCompat.Builder();
+            if (metadataObj.has("title")) builder.putString(MediaMetadataCompat.METADATA_KEY_TITLE, metadataObj.getString("title"));
+            if (metadataObj.has("subtitle")) builder.putString(MediaMetadataCompat.METADATA_KEY_ARTIST, metadataObj.getString("subtitle"));
+            if (metadataObj.has("images")) {
+                // Only use the first image for now
+                String img = metadataObj.getJSONArray("images").optString(0, null);
+                if (img != null) builder.putString(MediaMetadataCompat.METADATA_KEY_ALBUM_ART_URI, img);
+            }
+            if (metadataObj.has("studio")) builder.putString(MediaMetadataCompat.METADATA_KEY_AUTHOR, metadataObj.getString("studio"));
+            if (metadataObj.has("contentType")) builder.putString(MediaMetadataCompat.METADATA_KEY_MEDIA_URI, metadataObj.getString("contentType"));
+            if (metadataObj.has("duration")) builder.putLong(MediaMetadataCompat.METADATA_KEY_DURATION, metadataObj.getLong("duration"));
+            metadata = builder.build();
+        }
+        boolean success = implementation.loadMedia(url, metadata);
+        JSObject ret = new JSObject();
+        ret.put("success", success);
+        if (success) {
+            ret.put("message", "Media sent to Cast device.");
+            call.resolve(ret);
+        } else {
+            ret.put("message", "Failed to send media. Check session and device.");
+            call.reject("Failed to send media", ret);
+        }
+    }
+}

package/dist/docs.json

@@ -0,0 +1,371 @@
+{
+  "api": {
+    "name": "IonicChromecastPlugin",
+    "slug": "ionicchromecastplugin",
+    "docs": "",
+    "tags": [],
+    "methods": [
+      {
+        "name": "initialize",
+        "signature": "(options: InitializeOptions) => Promise<{ success: boolean; }>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "InitializeOptions"
+          }
+        ],
+        "returns": "Promise<{ success: boolean; }>",
+        "tags": [],
+        "docs": "Initialize the Google Cast SDK\nMust be called before any other Cast operations",
+        "complexTypes": [
+          "InitializeOptions"
+        ],
+        "slug": "initialize"
+      },
+      {
+        "name": "echo",
+        "signature": "(options: { value: string; }) => Promise<{ value: string; }>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "{ value: string; }"
+          }
+        ],
+        "returns": "Promise<{ value: string; }>",
+        "tags": [],
+        "docs": "",
+        "complexTypes": [],
+        "slug": "echo"
+      },
+      {
+        "name": "requestSession",
+        "signature": "() => Promise<RequestSessionResult>",
+        "parameters": [],
+        "returns": "Promise<RequestSessionResult>",
+        "tags": [],
+        "docs": "Request a Cast session (Android only)",
+        "complexTypes": [
+          "RequestSessionResult"
+        ],
+        "slug": "requestsession"
+      },
+      {
+        "name": "isSessionActive",
+        "signature": "() => Promise<SessionStatusResult>",
+        "parameters": [],
+        "returns": "Promise<SessionStatusResult>",
+        "tags": [],
+        "docs": "Check if there is an active Cast session (Android only)",
+        "complexTypes": [
+          "SessionStatusResult"
+        ],
+        "slug": "issessionactive"
+      },
+      {
+        "name": "areDevicesAvailable",
+        "signature": "() => Promise<DevicesAvailableResult>",
+        "parameters": [],
+        "returns": "Promise<DevicesAvailableResult>",
+        "tags": [],
+        "docs": "Check if there are available Cast devices (Android only)",
+        "complexTypes": [
+          "DevicesAvailableResult"
+        ],
+        "slug": "aredevicesavailable"
+      },
+      {
+        "name": "loadMedia",
+        "signature": "(options: LoadMediaOptions) => Promise<{ success: boolean; message?: string; }>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "LoadMediaOptions"
+          }
+        ],
+        "returns": "Promise<{ success: boolean; message?: string | undefined; }>",
+        "tags": [],
+        "docs": "Load media on the Cast device (Android only)",
+        "complexTypes": [
+          "LoadMediaOptions"
+        ],
+        "slug": "loadmedia"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: ChromecastEventType, listenerFunc: (event: ChromecastEvent) => void) => PluginListenerHandle",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "ChromecastEventType"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(event: ChromecastEvent) => void"
+          }
+        ],
+        "returns": "PluginListenerHandle",
+        "tags": [],
+        "docs": "Listen to Chromecast events (Android only)",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "ChromecastEventType",
+          "ChromecastEvent"
+        ],
+        "slug": "addlistenerchromecasteventtype-"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [
+    {
+      "name": "InitializeOptions",
+      "slug": "initializeoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "receiverApplicationId",
+          "tags": [],
+          "docs": "The receiver application ID for Google Cast\nUse \"CC1AD845\" for the default media receiver",
+          "complexTypes": [],
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "name": "RequestSessionResult",
+      "slug": "requestsessionresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "success",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "message",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "SessionStatusResult",
+      "slug": "sessionstatusresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "active",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "message",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "DevicesAvailableResult",
+      "slug": "devicesavailableresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "available",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "message",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    },
+    {
+      "name": "LoadMediaOptions",
+      "slug": "loadmediaoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "url",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "metadata",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "MediaMetadata"
+          ],
+          "type": "MediaMetadata"
+        }
+      ]
+    },
+    {
+      "name": "MediaMetadata",
+      "slug": "mediametadata",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "title",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "subtitle",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "images",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string[] | undefined"
+        },
+        {
+          "name": "studio",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "contentType",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "duration",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "number | undefined"
+        }
+      ]
+    },
+    {
+      "name": "PluginListenerHandle",
+      "slug": "pluginlistenerhandle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "remove",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "() => Promise<void>"
+        }
+      ]
+    },
+    {
+      "name": "ChromecastEvent",
+      "slug": "chromecastevent",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "type",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "ChromecastEventType"
+          ],
+          "type": "ChromecastEventType"
+        },
+        {
+          "name": "data",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "any"
+        }
+      ]
+    }
+  ],
+  "enums": [],
+  "typeAliases": [
+    {
+      "name": "ChromecastEventType",
+      "slug": "chromecasteventtype",
+      "docs": "",
+      "types": [
+        {
+          "text": "'sessionStarted'",
+          "complexTypes": []
+        },
+        {
+          "text": "'sessionEnded'",
+          "complexTypes": []
+        },
+        {
+          "text": "'mediaLoaded'",
+          "complexTypes": []
+        },
+        {
+          "text": "'mediaError'",
+          "complexTypes": []
+        },
+        {
+          "text": "'deviceAvailable'",
+          "complexTypes": []
+        },
+        {
+          "text": "'deviceUnavailable'",
+          "complexTypes": []
+        },
+        {
+          "text": "'volumeChanged'",
+          "complexTypes": []
+        },
+        {
+          "text": "'playbackStatusChanged'",
+          "complexTypes": []
+        }
+      ]
+    }
+  ],
+  "pluginConfigs": []
+}