Merge pull request #2 from Novage/docs/update-readme

Docs: add Kotlin & Java examples to README file

README.md

@@ -36,7 +36,7 @@ dependencyResolutionManagement {
 Add the following implementation line to your **`build.gradle`** (app module):
 
 ```kotlin
-implementation("com.github.Novage:p2p-media-loader-mobile:main-d71e8e4552-1")
+implementation("com.github.Novage:p2p-media-loader-mobile:main-SNAPSHOT")
 ```
 
 ### Step 3: Configure the AndroidManifest
@@ -80,3 +80,234 @@ Make sure to reference this file in the `<application>` tag of your **`AndroidMa
 
 Once you've completed the setup, P2P Media Loader is ready to use in your application!
 
+### Kotlin Example
+
+```kotlin
+class MainActivity : ComponentActivity() {
+    companion object {
+        // URL to the media manifest
+        private const val MANIFEST_URL = "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8"
+
+        // JSON configuration for P2P Media Loader
+        private const val CORE_CONFIG_JSON = "{\"swarmId\":\"TEST_KOTLIN\"}"
+
+        // Port on which the P2P server will run
+        private const val SERVER_PORT = 8081
+    }
+
+    private lateinit var exoPlayer: ExoPlayer
+    private lateinit var p2pml: P2PMediaLoader
+
+    // State variables to manage UI state
+    private val isLoading = mutableStateOf(true)
+    private val videoTitle = mutableStateOf("Loading Video...")
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        enableEdgeToEdge()
+
+        // Initialize ExoPlayer
+        exoPlayer = ExoPlayer.Builder(this).build()
+
+        // Initialize P2P Media Loader with callbacks
+        p2pml = P2PMediaLoader(
+            onP2PReadyCallback = { initializePlayback() },
+            onP2PReadyErrorCallback = { onP2PReadyErrorCallback(it) },
+            coreConfigJson = CORE_CONFIG_JSON,
+            serverPort = SERVER_PORT,
+        )
+
+        // Start P2P Media Loader with the activity context and ExoPlayer instance
+        p2pml.start(this, exoPlayer)
+
+        // Listener to update UI based on playback state
+        exoPlayer.addListener(object : Player.Listener {
+            override fun onPlaybackStateChanged(playbackState: Int) {
+                if (playbackState == Player.STATE_READY) {
+                    isLoading.value = false
+                    videoTitle.value = "Big Buck Bunny"
+                }
+            }
+        })
+
+        // Set the Compose UI content
+        setContent {
+            ExoPlayerScreen(
+                player = exoPlayer,
+                videoTitle = videoTitle.value,
+                isLoading = isLoading.value,
+            )
+        }
+    }
+
+    private fun initializePlayback() {
+        val manifest = p2pml.getManifestUrl(MANIFEST_URL)
+
+        val httpDataSource = DefaultHttpDataSource.Factory()
+            .setReadTimeoutMs(15000) // Read timeout
+            .setConnectTimeoutMs(15000) // Connect timeout
+
+        val mediaItem = MediaItem.fromUri(manifest)
+        val mediaSource = HlsMediaSource.Factory(httpDataSource)
+            .createMediaSource(mediaItem)
+
+        exoPlayer.apply {
+            playWhenReady = true
+            setMediaSource(mediaSource)
+            prepare()
+        }
+    }
+
+    private fun onP2PReadyErrorCallback(error: String) {
+        // Implement error handling logic here
+    }
+
+    override fun onStop() {
+        super.onStop()
+        // Disable P2P features when the activity stops
+        p2pml.applyDynamicConfig("{\"isP2PDisabled\": true}")
+    }
+
+    override fun onRestart() {
+        super.onRestart()
+        // Re-enable P2P features when the activity restarts
+        p2pml.applyDynamicConfig("{\"isP2PDisabled\": false}")
+    }
+
+    override fun onDestroy() {
+        super.onDestroy()
+        // Release ExoPlayer resources and stop P2P Media Loader
+        exoPlayer.release()
+        p2pml.stop()
+    }
+}
+```
+
+### Java Example
+
+```Java
+public class MainActivity extends AppCompatActivity {
+    // URL to the media manifest
+    private static final String MANIFEST_URL = "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8";
+
+    // JSON configuration for P2P Media Loader
+    private static final int SERVER_PORT = 8081;
+
+    // Port on which the P2P server will run
+    private static final String CORE_CONFIG_JSON = "{\"swarmId\":\"TEST_KOTLIN\"}";
+
+    private ExoPlayer exoPlayer;
+    private P2PMediaLoader p2pMediaLoader;
+
+    private PlayerView playerView;
+    private ProgressBar loadingIndicator;
+    private TextView videoTitle;
+
+    private void initializePlayback() {
+        String manifestUrl = p2pMediaLoader.getManifestUrl(MANIFEST_URL);
+
+        DefaultHttpDataSource.Factory dataSourceFactory = new DefaultHttpDataSource.Factory()
+                .setConnectTimeoutMs(15000) // Set the connection timeout
+                .setReadTimeoutMs(15000); // Set the read timeout
+
+        MediaItem mediaItem = MediaItem.fromUri(manifestUrl);
+        HlsMediaSource mediaSource = new HlsMediaSource
+                .Factory(dataSourceFactory)
+                .createMediaSource(mediaItem);
+
+
+        exoPlayer.setMediaSource(mediaSource);
+        exoPlayer.prepare();
+        exoPlayer.setPlayWhenReady(true);
+
+        playerView.setPlayer(exoPlayer);
+    }
+
+    private void onP2PReadyErrorCallback(String error) {
+       // Implement error handling logic here
+    }
+
+    private void initializeUI() {
+        playerView = findViewById(R.id.playerView);
+        loadingIndicator = findViewById(R.id.loadingIndicator);
+        videoTitle = findViewById(R.id.videoTitle);
+
+        loadingIndicator.setVisibility(View.VISIBLE);
+    }
+
+    private void applyWindowInsets() {
+        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (view, insets) -> {
+            Insets systemBarsInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars());
+            view.setPadding(systemBarsInsets.left, systemBarsInsets.top,
+                    systemBarsInsets.right, systemBarsInsets.bottom);
+            return insets;
+        });
+    }
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        EdgeToEdge.enable(this);
+        setContentView(R.layout.activity_main);
+
+        // Initialize ExoPlayer
+        exoPlayer = new ExoPlayer.Builder(this).build();
+
+        // Initialize P2P Media Loader with callbacks
+        p2pMediaLoader = new P2PMediaLoader(
+            this::initializePlayback,
+            this::onP2PReadyErrorCallback,
+            SERVER_PORT,
+            CORE_CONFIG_JSON
+        );
+
+        // Start P2P Media Loader with the activity context and ExoPlayer instance
+        p2pMediaLoader.start(this, exoPlayer);
+
+        // Listener to update UI based on playback state
+        exoPlayer.addListener(new Player.Listener() {
+            @Override
+            public void onPlaybackStateChanged(int playbackState) {
+                if (playbackState != Player.STATE_READY) return;
+
+                loadingIndicator.setVisibility(View.GONE);
+                videoTitle.setText("Big Buck Bunny");
+            }
+        });
+
+
+        initializeUI();
+        applyWindowInsets();
+    }
+
+    @Override
+    protected void onRestart() {
+        super.onRestart();
+        // Disable P2P features when the activity stops
+        if (p2pMediaLoader != null) {
+            p2pMediaLoader.applyDynamicConfig("{ \"isP2PDisabled\": false }");
+        }
+    }
+
+    @Override
+    protected void onStop() {
+        super.onStop();
+        // Re-enable P2P features when the activity restarts
+        if (p2pMediaLoader != null) {
+            p2pMediaLoader.applyDynamicConfig("{ \"isP2PDisabled\": true }");
+        }
+    }
+
+    @Override
+    protected void onDestroy() {
+        super.onDestroy();
+        // Release ExoPlayer resources and stop P2P Media Loader
+        if (p2pMediaLoader != null) {
+            p2pMediaLoader.stop();
+        }
+        if (exoPlayer != null) {
+            exoPlayer.release();
+        }
+    }
+}
+```