Radio

You can control the radio hardware in a device to provide radio playback in your application.

The main features of the Tizen.Multimedia.Radio class include the following:

You can only have one radio instance active at a time. Radio playback can be interrupted by another radio application.

Prerequisites

To enable your application to use the radio functionality, proceed as follows:

  1. To use the methods and properties of the Tizen.Multimedia.Radio class, include the Tizen.Multimedia namespace in your application:

    C#
    Copy
    using Tizen.Multimedia;
  2. Create an instance of the Tizen.Multimedia.Radio class:

    C#
    Copy
    Radio radio = new Radio();
  3. To receive notifications when radio playback is interrupted, register an event handler for the Interrupted event of the Tizen.Multimedia.Radio class. Radio playback is interrupted, for example, when the radio application moves to the background:

    C#
    Copy
    radio.Interrupted += OnRadioInterrupted; void OnRadioInterrupted(object sender, RadioInterruptedEventArgs args) { switch (args.Reason) { case RadioInterruptedReason.ResourceConflict: /// Application that was the source of the conflict is now closed /// Restart the radio playback here break; default: /// Radio listening is interrupted /// Release the application resources or save the current state here break; } }

Scan for radio frequencies

To scan for all available radio frequencies, proceed as follows:

  1. Register and define event handlers for the events of the Tizen.Multimedia.Radio class:

    • To receive a notification each time the scan finds a new frequency, register an event handler for the ScanUpdated event. The event provides the kHz value of the found frequency:

      C#
      Copy
      radio.ScanCompleted += OnScanCompleted; void OnScanUpdated(object sender, ScanUpdatedEventArgs args) { /// Store the radio channels in the array /// Frequency values represent the kHz of the channel Tizen.Log.Info("Radio", $"Frequency: {args.Frequency}"); }
      Note

      Do not use radio operations (such as changing the Frequency property value or calling the Start() method) in the scan updated event handler.

    • To receive a notification when the scan is complete, register an event handler for the ScanCompleted event:

      C#
      Copy
      radio.ScanCompleted += OnScanCompleted; void OnScanCompleted(object sender, EventArgs args) { /// Frequency scanning is completed /// Tune in to one of the scanned frequencies and start listening }
  2. Start scanning using the StartScan() method of the Tizen.Multimedia.Radio class:

    C#
    Copy
    radio.StartScan();

    The scanning time depends on the environment (the strength of the radio signal).

    To cancel the scan before it completes, use the StopScan() method.

Tuning the radio

To select and start playing a frequency, proceed as follows:

  1. Set the frequency you want to play using the Frequency property of the Tizen.Multimedia.Radio class:

    C#
    Copy
    radio.Frequency = newFrequency;
  2. Start playing the frequency using the Start() method of the Tizen.Multimedia.Radio class:

    C#
    Copy
    radio.Start();

    If the radio emits no sound, check the signal strength with the SignalStrength property of the Tizen.Multimedia.Radio class. The property returns the current signal strength as a dBuV value.

Search for an adjacent channel

To search for and tune in to an adjacent channel, use the SeekUpAsync() and SeekDownAsync() methods of the Tizen.Multimedia.Radio class. This is similar to the scanning operation, but only the nearest active frequency is searched for. Once the maximum frequency is reached in either direction, the search ends, and the radio is set to that frequency.

For example, to seek down, use the SeekDownAsync() method:

C#
Copy
var newFrequency = await radio.SeekDownAsync(); /// Search is complete, and the radio is tuned in to the new frequency /// Application sets the new frequency and updates the user interface
  • Dependencies
    • Tizen 4.0 and Higher
Screen Mirroring
Next Camera
Submit your feedback to GitHub