*
* @remarks
* The maximum number of %AudioOut instances is limited by Media::MediaCapability class.
- * However, prepare functions can fail because this maximum count is a system wide and the practical limited count is smaller depending on CPU model,
- * CPU speed, number of CPU cores, CPU load from other applications and available memory.
+ * However, the maximum count is a system wide count and it can be practically applied depending on the CPU model, CPU speed, number of CPU cores, CPU load from other applications, and the available memory.
+ * Thus, the exact count can be smaller than the maximum count, in which case the %Prepare() methods will fail.
+ *
+ * @see Prepare(AudioSampleType, AudioChannelType, int)
+ * @see Prepare(AudioStreamType, AudioSampleType, AudioChannelType, int)
*
*
* The %AudioOut class plays raw audio data and provides methods for:
* - Playing back multiple audio streams.
*
* The maximum count of the %Player instance is limited by Media::MediaCapability class.
- * However, open functions can fail because this maximum count is a system wide and the practical limited count is smaller depending on CPU model,
- * CPU speed, number of CPU cores, CPU load from other applications and available memory.
+ * However, the maximum count is a system wide count and it can be practically applied depending on the CPU model, CPU speed, number of CPU cores, CPU load from other applications, and the available memory.
+ * Thus, the exact count can be smaller than the maximum count, in which case the open methods will fail.
+ *
+ * @see OpenFile()
+ * @see OpenBuffer()
+ * @see OpenUrl()
+ * @see OpenUrlAsync(const Tizen::Base::String, const Tizen::Base::Collection::IMap*)
+ * @see OpenUrlAsync(const Tizen::Base::String&, const Tizen::Base::String&, IPlayerProgressiveDownloadListener&, const Tizen::Base::Collection::IMap*)
*
* For more information on the class features, see <a href="../org.tizen.native.appprogramming/html/guide/media/playing_audio.htm">Playing Audio</a> and <a href="../org.tizen.native.appprogramming/html/guide/media/playing_video.htm">Playing Video</a>.
*
* @see GetVolume()
* @see IsMuted()
* @see SetMute()
- * @remarks When this method is called after open functions, the initial audio packet is not applied with the given audio volume. Thus this method should be called before open functions
- * if the application wants to start playback of media content with the given audio volume.
- *
+ * @remarks If an application wants to start a playback of the media content with the given audio sound, this method should be called before calling the Open methods.
+ * This is because the initial audio packet is not applied as the given audio volume if this method is called after the open methods have been called.
*/
result SetVolume(int volume);
* @see GetVolume()
* @see SetVolume()
* @see IsMuted()
- * @remarks When this method is called after open functions, the initial audio packet is not applied with the given audio volume. Thus this method should be called before open functions
- * if the application wants to start playback of media content without sound.
+ * @remarks If an application wants to start a playback of the media content without any sound, this method should be called before calling the Open methods.
+ * This is because the initial audio packet is not applied as the given audio volume if this method is called after the open methods have been called.
*/
result SetMute(bool mute);
*
* @remarks
* The maximum number of the %TonePlayer instance is limited by Media::MediaCapability class.
- * However, open functions can fail because this maximum count is a system wide and the practical limited count is smaller depending on CPU model,
- * CPU speed, number of CPU cores, CPU load from other applications and available memory.
+ * However, the maximum count is a system wide count and it can be practically applied depending on the CPU model, CPU speed, number of CPU cores, CPU load from other applications, and the available memory.
+ * Thus, the exact count can be smaller than the maximum count, in which case the open methods will fail.
+ *
+ * @see Open(const Tizen::Base::Collection::IList&, int)
+ * @see Open(const Tizen::Media::Tone&, int)
*
* The %TonePlayer class provides methods for:
* - Playing the tone(s)