Monitor and control connections made via MediaCaster

Monitor and control connections made via MediaCaster with the Wowza Streaming Engine Java API

Updated on 07/16/2026 8:47 am PDT

The ModuleMediaCasterNotifyExample module for the Wowza Streaming Engine™ Java API adds an event listener to MediaCaster requests, providing an opportunity to monitor and control connections made via the MediaCaster system.

Code example [Copy to clipboard](/content/docs/imediacasternotify2-example#code-example "Copy to clipboard"/index.html)


Copy

package com.wowza.wms.example.module;

import com.wowza.wms.application.*;
import com.wowza.wms.mediacaster.IMediaCaster;
import com.wowza.wms.mediacaster.IMediaCasterNotify2;
import com.wowza.wms.module.*;
import com.wowza.wms.stream.IMediaStream;
import com.wowza.wms.stream.IMediaStreamPlay;

public class ModuleMediaCasterNotifyExample extends ModuleBase {

public void onAppStart(IApplicationInstance appInstance) {
        String fullname = appInstance.getApplication().getName() + "/"
                + appInstance.getName();
        getLogger().info("onAppStart: " + fullname);
        appInstance.addMediaCasterListener(new mediacasterNotify());
    }

public void onAppStop(IApplicationInstance appInstance) {
        String fullname = appInstance.getApplication().getName() + "/"
                + appInstance.getName();
        getLogger().info("onAppStop: " + fullname);
    }

class mediacasterNotify implements  IMediaCasterNotify2
    {

public void onConnectFailure(IMediaCaster mediaCaster) {

getLogger().info("onConnectFailure");
        }

public void onConnectStart(IMediaCaster mediaCaster) {

getLogger().info("onConnectStart");

}

public void onConnectSuccess(IMediaCaster mediaCaster) {

getLogger().info("onConnectSuccess");
        }

public void onStreamStart(IMediaCaster mediaCaster) {

getLogger().info("onStreamStart");
        }

public void onStreamStop(IMediaCaster mediaCaster) {

getLogger().info("onStreamStop");
        }

public void onMediaCasterCreate(IMediaCaster mediaCaster) {

getLogger().info("onMediaCasterCreate");
        }

public void onMediaCasterDestroy(IMediaCaster mediaCaster) {

getLogger().info("onMediaCasterDestroy");
        }

public void onRegisterPlayer(IMediaCaster mediaCaster,
                IMediaStreamPlay player) {

getLogger().info("onRegisterPlayer");
        }

public void onSetSourceStream(IMediaCaster mediaCaster,
                IMediaStream stream) {

getLogger().info("onSetSourceStream");
        }

public void onUnRegisterPlayer(IMediaCaster mediaCaster,
                IMediaStreamPlay player) {

getLogger().info("onUnRegisterPlayer");
        }

}

}

Use the module [Copy to clipboard](/content/docs/imediacasternotify2-example#use-the-module "Copy to clipboard"/index.html)


Use the ModuleMediaCasterNotifyExample module with an application named testlive. To install and configure the module, do the following:

  1. Compile the above code and then copy the .jar file to the [install-dir]/lib/ folder.
  2. Open [install-dir]/conf/testlive/Application.xml in a text editor then specify the StreamType as live.
  3. Add the following module definition as the last entry in the list:

Copy

<Module>
        <Name>ModuleMediaCasterNotifyExample</Name>
        <Description>ModuleMediaCasterNotifyExample</Description>
        <Class>com.wowza.wms.example.module.ModuleMediaCasterNotifyExample</Class>
</Module>
  1. Restart Wowza Streaming Engine if it was running.

Was this article helpful?

[Helpful](/content/docs/imediacasternotify2-example# "Helpful"/index.html)

Thank you for your feedback!

300 characters remaining

Name

Email

reCAPTCHA

Recaptcha requires verification.

I'm not a robot

reCAPTCHA

[Submit](/content/docs/imediacasternotify2-example# "Submit comment"/index.html)

Thank you for providing feedback to help us improve our documentation!

Popular Video Topics [Copy to clipboard](/content/docs/imediacasternotify2-example#popular-video-topics "Copy to clipboard"/index.html)
Video Resources [Copy to clipboard](/content/docs/imediacasternotify2-example#video-resources "Copy to clipboard"/index.html)
Partners [Copy to clipboard](/content/docs/imediacasternotify2-example#partners "Copy to clipboard"/index.html)
Company [Copy to clipboard](/content/docs/imediacasternotify2-example#company "Copy to clipboard"/index.html)
Stay Connected [Copy to clipboard](/content/docs/imediacasternotify2-example#stay-connected "Copy to clipboard"/index.html)
Stay Up to Date with the Blog [Copy to clipboard](/content/docs/imediacasternotify2-example#stay-up-to-date-with-the-blog "Copy to clipboard"/index.html)

Email

X - Form Filled Type

© 2007–2025 Wowza Media Systems™, LLC. All rights reserved.   Security & Privacy Policy | Legal | System Status

reCAPTCHA