BlackBerry Java Application Multimedia Version: 5.0. Entwicklungshandbuch

Transkript

1 BlackBerry Java Application Multimedia Version: 5.0 Entwicklungshandbuch

2 Veröffentlicht: SWD

3 Inhaltsverzeichnis 1 Arbeiten mit Multimediainhalten in einer BlackBerry-Geräteanwendung... 5 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt... 5 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt... 6 Codebeispiel: Wiedergeben von Medien über einen URI... 6 Codebeispiel: Wiedergeben einer Folge von Tönen... 7 Erstellen einer BlackBerry-Geräteanwendung, die Medien aus einem Eingabestream wiedergibt... 8 Erstellen einer BlackBerry-Geräteanwendung, die Media-Streaming wiedergibt... 9 Erstellen einer BlackBerry-Geräteanwendung, die ein Video in einem Benutzeroberflächenfeld wiedergibt... 9 Erstellen einer BlackBerry-Geräteanwendung, die ein Foto mit der Kamera aufnimmt Erstellen einer BlackBerry-Geräteanwendung, die Audiodaten an ein Bluetooth-fähiges Gerät sendet Erstellen einer Content-Handler-Anwendung, die Medien wiedergibt Codebeispiel: Erstellen einer Content-Handler-Anwendung, die Medien wiedergibt Festlegen der Funktionen einer BlackBerry-Geräteanwendung, die Medien wiedergibt Abfragen der von einer BlackBerry-Geräteanwendung unterstützten Funktionen zur Medienwiedergabe Festlegen der Parameter für die Videowiedergabe innerhalb einer BlackBerry-Geräteanwendung Festlegen der Lautstärke, mit der eine BlackBerry-Geräteanwendung Medien wiedergibt Reagieren auf Benutzereingaben Empfangen einer Benachrichtigung, wenn ein Benutzer eine Medientaste auf einem BlackBerry-Gerät drückt Reagieren auf das Drücken einer Lautstärketaste durch einen BlackBerry-Gerätebenutzer Reagieren auf eine Statusänderung eines Player-Objekts Media-Streaming in einer BlackBerry-Geräteanwendung RIMM-Streaming-Videodatei Proprietäres RIM-Videoformat (RIMM-Streaming-Datei) Puffern und Wiedergeben von per Streaming übertragenen Medieninhalten Codebeispiel: Media-Streaming in einer BlackBerry-Geräteanwendung Codebeispiel: Lesen von Daten aus einem Puffer Codebeispiel: Media-Streaming mithilfe einer Datei auf dem BlackBerry-Gerät Codebeispiel: Analysieren einer RIMM-Streaming-Videodatei Aufzeichnen von Medien mithilfe einer BlackBerry-Geräteanwendung Aufzeichnen von Audiodaten in einer BlackBerry-Geräteanwendung Codebeispiel: Aufzeichnen von Audiodaten aus einem Player Aufzeichnen eines Videos mit der BlackBerry-Videoaufzeichnungsanwendung... 39

4 Aufzeichnen von Videos mithilfe der Multimedia-API Codebeispiel: Aufzeichnen von Videos mit der Multimedia-API Wiedergeben von Medien in der Medienanwendung des BlackBerry-Geräts Starten der Medienanwendung mit oder ohne Inhalte Wiedergeben von Audioinhalten im BlackBerry Browser Wiedergeben eines Videos im BlackBerry Browser Arbeiten mit Bildern aus der Kameraanwendung Starten der Kamera aus einer BlackBerry-Geräteanwendung Erstellen einer Content-Handler-Anwendung, die Medien wiedergibt Codebeispiel: Erstellen einer Content-Handler-Anwendung, die Medien wiedergibt Empfangen einer Benachrichtigung über Dateisystemereignisse Erkennen, wenn ein Bild im Dateisystem des BlackBerry-Geräts hinzugefügt oder entfernt wird Abrufen eines Bilds Verschieben eines Bilds innerhalb desselben Verzeichnisses des Dateisystems Verschieben eines Bilds in ein anderes Verzeichnis des Dateisystems Löschen eines Bilds aus dem Dateisystem Zeichnen und Positionieren von Bildern Positionieren eines Bilds Überprüfen, ob das BlackBerry-Gerät ein Farbdisplay unterstützt Abrufen der Anzahl der Farben, die der BlackBerry-Gerätebildschirm unterstützt Konfigurieren der Pixeltransparenz im Zeichenbereich Abfragen der von der BlackBerry-Geräteanwendung unterstützten Rastervorgänge Zeichnen eines schattierten und ausgefüllten Pfads Codebeispiel: Zeichnen eines Pfads auf dem Bildschirm einer BlackBerry-Geräteanwendung, dessen Farbe von Blau in Rot übergeht Aktivieren oder Deaktivieren eines Zeichenstils Bestimmen, ob ein Zeichenstil konfiguriert ist Codebeispiel: Bestimmen, ob der festgelegte Zeichenstil aktiviert ist Verwenden eines monochromen Bitmap-Bilds als Stempel Codebeispiel: Veranschaulichen der Verwendung eines monochromen Bitmap-Bilds als Stempel Erstellen eines Bitmap-Bilds mithilfe eines anderen Bitmap-Bilds Erstellen eines Bitmap-Bilds, das den skalierten Inhalt eines anderen Bitmap-Bilds enthält Duplizieren eines Bitmap-Bilds Erstellen eines Bitmap-Bilds, das einen Teil des Inhalts eines anderen Bitmap-Bilds enthält... 72

5 Zeichnen eines Bilds auf einem leeren Bitmap-Bild Interpolationsfilter Anzeigen von Bildern Anzeigen eines Bilds zum Vergrößern/Verkleinern und Schwenken Anzeigen eines Bilds zum Vergrößern/Verkleinern und Schwenken Codebeispiel: Anzeigen eines Bilds zum Vergrößern/Verkleinern und Schwenken Anzeigen einer Reihe von Bildern zum Scrollen Anzeigen einer Reihe von Bildern zum Scrollen Codebeispiel: Anzeigen einer Reihe von Bildern zum Scrollen Verwenden unbearbeiteter Bilder Abrufen unverarbeiteter Bilddaten Speichern unverarbeiteter Bilddaten Vergleichen von zwei unbearbeiteten Bildern Vergleichen von zwei Bitmap-Bildern, um sie auf Unterschiede zu prüfen Verwenden von codierten Bildern Zugriff auf ein codiertes Bild über einen Eingabestream Codieren eines Bilds Anzeigen eines codierten Bilds Festlegen des Decodierungsmodus für ein Bild Festlegen der Anzeigegröße eines codierten Bilds Verwenden von SVG-Inhalten in einer BlackBerry-Geräteanwendung Herunterladen von SVG-Inhalten Wiedergeben von Rich Media-Inhalten Empfangen von Ereignissen beim Herunterladen einer PME-Datei Reagieren auf Ereignisse beim Herunterladen einer PME-Datei Codebeispiel: Reagieren auf Ereignisse, wenn eine BlackBerry-Geräteanwendung SVG-Inhalte herunterlädt Herunterladen und Wiedergeben einer PME-Datei Wiedergeben von SVG-Inhalten Zugriff auf SVG-Inhalte über eine Verbindung, die von MediaManager nicht unterstützt wird Codebeispiel: Implementieren eines benutzerdefinierten Connector-Frameworks Erstellen von 2D- und 3D-Grafiken mithilfe von JSR Pakete für die Unterstützung von JSR

6 Codebeispiel: Rendering eines mehrfarbigen 2D-Dreiecks Codebeispiel: Zeichnen eines 3D-Würfels Codebeispiel: Zeichnen eines 3D-Würfels D-Mathematikprogramme Codebeispiel: Verwenden von Festkommaarithmetik Glossar Rückmeldung Verlauf der Dokumentrevision Rechtliche Hinweise

7 Arbeiten mit Multimediainhalten in einer BlackBerry-Geräteanwendung Arbeiten mit Multimediainhalten in einer BlackBerry- Geräteanwendung 1 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt Sie können eine BlackBerry -Geräteanwendung erstellen, die Medien im BlackBerry Browser oder in der Medienanwendung auf einem BlackBerry-Gerät wiedergibt. Es kann auch eine Medienanwendung für das BlackBerry-Gerät zur Wiedergabe von Audio-, Video- und binären SVG-Inhalten erstellt werden. Darüber hinaus kann eine BlackBerry-Geräteanwendung zum Aufzeichnen von Audio- und Videoinhalten und zum Senden von Audiodaten an ein Bluetooth -fähiges Headset erstellt werden. Die Content-Handler-API (CHAPI) wird auch zur Bereitstellung eines Ausführungsmodells für den Remote-Aufruf von nicht zentralen BlackBerry-Geräteanwendungen verwendet. CHAPI ist eine ideale Methode für das Festlegen von Aufrufparametern für nicht zentrale BlackBerry-Geräteanwendungen. Mithilfe von CHAPI können Sie Anwendungen aufrufen, indem Sie bei der Verwendung eines der in der javax.microedition.content.invocation-klasse verfügbaren Konstruktoren eine URL, einen Inhaltstyp oder eine Inhalts-ID angeben. Anmerkung: CHAPI versucht, eine Aufrufantwort abzurufen, sofern Sie nicht explizit festlegen, dass keine Antwort erforderlich ist. Sie können eine BlackBerry-Geräteanwendung für die Wiedergabe von Medien erstellen, die die Player-Schnittstelle und das javax.microedition.media-paket verwendet. Die Player-Schnittstelle wurde von RIM implementiert. Sie stellt die Methoden bereit, die zum Verwalten der verschiedenen Zustände einer BlackBerry-Geräteanwendung, die Medien wiedergibt, und zum Steuern der Wiedergabe von Mediendateien benötigt werden. Ein Player-Objekt wird zuerst im Zustand UNREALIZED erstellt. In diesem Zustand kann das Objekt aufgrund mangelnder Informationen und Ressourcen keine Aktionen ausführen. Durch Aufrufen von realize() wird der Player in den Zustand REALIZED versetzt. Dadurch kann der Player nach Informationen suchen, um die grundlegenden Ressourcen für die Wiedergabe eine Mediendatei zu erhalten. Durch Aufrufen von prefetch() wird der Player in den Zustand PREFETCHED versetzt. In diesem Zustand erhält der Player erforderliche Ressourcen und "ruft" dann einen Teil der Mediendatei ab, um sofort die Wiedergabe zu starten, sobald der Player gestartet wurde. Durch Aufrufen von start() wird der Player in den Zustand STARTED versetzt, in dem der Player die sofortige Wiedergabe der Medien startet. Es ist möglich, start() ohne Aufruf von realize() und prefetch() aufzurufen. Mit der start()-methode wird prefetch(0) aufgerufen, wodurch realize() aufgerufen wird, bevor die Medienwiedergabe gestartet werden kann. Die Einfachheit, die sich ergibt, wenn start() auf diese Weise verwendet wird, wird möglicherweise durch höhere Verzögerungen beim Start der Medienwiedergabe ausgeglichen. 5

8 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt Weitere Informationen zu Medientypen, die vom BlackBerry-Gerät unterstützt werden, finden Sie im Knowledge Base-Artikel KB05482 unter Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt 1. Importieren Sie die erforderlichen Klassen. import javax.microedition.media.manager; import javax.microedition.media.player; import java.io.ioexception; 2. Rufen Sie ein Player-Objekt aus der Manager-Klasse ab, indem Sie die createplayer()-methode aufrufen. 3. Rufen Sie Player.realize() auf, um die BlackBerry -Geräteanwendung auf das Abrufen der von ihr benötigten Ressourcen vorzubereiten. 4. Rufen Sie Player.prefetch() auf, um die BlackBerry-Geräteanwendung Aktionen ausführen zu lassen, die stattfinden müssen, bevor die BlackBerry-Geräteanwendung Medien wiedergeben kann. 5. Rufen Sie Player.start() auf, um die Wiedergabe von Medien zu starten. Player p = Manager.createPlayer(" * Best practice is to invoke realize(), then prefetch(), then start(). * Following this sequence reduces delays in starting media playback. * * Invoking start() as shown below will cause start() to invoke prefetch(0), * which invokes realize() before media playback is started. p.start(); 6. Rufen Sie Player.stop() auf, um die Wiedergabe von Medien zu beenden. 7. Rufen Sie Player.close() auf, um den Player in den Zustand CLOSED zu versetzen. Codebeispiel: Wiedergeben von Medien über einen URI private void initvideo(string url) try _player = javax.microedition.media.manager.createplayer(url); _player.realize(); _vc = (VideoControl) _player.getcontrol("videocontrol"); if (_vc!= null) _videofield = (Field) _vc.initdisplaymode( VideoControl.USE_GUI_PRIMITIVE, "net.rim.device.api.ui.field"); _vc.setvisible(true); catch(mediaexception pe) System.out.println(pe.toString()); 6

9 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt catch (IOException ioe) System.out.println(ioe.toString()); Codebeispiel: Wiedergeben einer Folge von Tönen ToneControl wird verwendet, um auf einem BlackBerry -Gerät eine benutzerdefinierte Folge von Noten mit einer bestimmten Länge und in einem bestimmten Tempo wiederzugeben. // "Mary Had A Little Lamb" has "ABAC" structure // Use block to repeat "A" section // Tempos ranging from 20 to 508 beats per minute are divided by 4 // to create a tempo modifier range of 5 to 127. byte tempo_mod = 30; // 120 bpm // Note duration ranges from 128 (1/2 note) to 0 (128th of a note) // with a default resolution of 64. byte duration = 8; // Note length 8 (quaver) = 1/8th of a note duration // Notes are determined from ToneControl.C4 (Middle C), // which has a value of 60 and a frequency of Hz. byte C4 = ToneControl.C4; // C note value = 60 (middle C) byte D4 = (byte)(c4 + 2); // D note value = 62 (a whole step) byte E4 = (byte)(c4 + 4); // E note value = 64 (a major third) byte G4 = (byte)(c4 + 7); // G note value = 67 (a fifth) byte rest = ToneControl.SILENCE; // rest byte[] mysequence = ToneControl.VERSION, 1, // version 1 ToneControl.TEMPO, tempo_mod, // // Start define "A" section ToneControl.BLOCK_START, 0, // // Content of "A" section E4, duration, D4, duration, C4, duration, E4, duration, E4, duration, E4, duration, E4, duration, rest, duration, // // End define "A" section ToneControl.BLOCK_END, 0, // end of block number 0 // // Play "A" section ToneControl.PLAY_BLOCK, 0, // // Play "B" section D4, duration, D4, duration, D4, duration, rest, duration, E4, duration, G4, duration, G4, duration, rest, duration, // // Repeat "A" section ToneControl.PLAY_BLOCK, 0, // // Play "C" section 7

10 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt D4, duration, D4, duration, E4, duration, D4, duration, C4, duration ; try Player p = Manager.createPlayer(Manager.TONE_DEVICE_LOCATOR); p.realize(); ToneControl c = (ToneControl)p.getControl("ToneControl"); c.setsequence(mysequence); p.start(); catch (IOException ioe) catch (MediaException me) Erstellen einer BlackBerry-Geräteanwendung, die Medien aus einem Eingabestream wiedergibt 1. Importieren Sie die erforderlichen Klassen. import java.lang.class; import javax.microedition.media.player; import javax.microedition.media.manager; import javax.microedition.rms.recordstore; import java.io.inputstream; import java.io.bytearrayinputstream; import net.rim.device.api.media.protocol.bytearrayinputstreamdatasource; 2. Erstellen Sie ein ByteArrayInputStream-Objekt. In diesem Beispiel wird getresourceasstream(string) aufgerufen, um die Mediendatei aus der Ressourcendatei an einem absoluten Speicherort abzurufen. ByteArrayInputStream stream = (ByteArrayInputStream)this.getClass ().getresourceasstream("/abc.mp3"); 3. Erstellen Sie einen durchsuchbaren SourceStream, indem Sie ein ByteArrayInputStreamDataSource-Objekt durch Übergeben des ByteArrayInputStream-Objekts erstellen. ByteArrayInputStreamDataSource source = new ByteArrayInputStreamDataSource (stream, "audio/mpeg"); 4. Rufen Sie ein Player-Objekt durch Aufrufen von Manager.createPlayer() ab und starten Sie dann mit start () die Medienwiedergabe. Player p = Manager.createPlayer(source); p.start(); 5. Sie könnten auch eine nicht durchsuchbare Methode verwenden, um wie im folgenden Codebeispiel Medien aus einem InputStream wiederzugeben. InputStream stream = (InputStream)this.getClass().getResourceAsStream("/abc.mp3"); Player p = Manager.createPlayer(stream, "audio/mpeg"); p.start(); 8

11 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt Erstellen einer BlackBerry-Geräteanwendung, die Media-Streaming wiedergibt BlackBerry -Geräte mit BlackBerry Device Software Version oder höher, die EVDO unterstützt, unterstützen RTSP- Funktionalität. 1. Importieren Sie die erforderlichen Klassen. import javax.microedition.media.manager; import javax.microedition.media.player; 2. Rufen Sie zum Streaming von Medien Manager.createPlayer(String) auf, indem Sie einen Parameter übergeben, der einen RTSP-Locator darstellt. Player p = Manager.createPlayer("rtsp://streaming.rim com/streaming_video.3gp"); Erstellen einer BlackBerry-Geräteanwendung, die ein Video in einem Benutzeroberflächenfeld wiedergibt 1. Importieren Sie die erforderlichen Klassen und Schnittstellen. import net.rim.device.api.ui.field; import javax.microedition.media.manager; import javax.microedition.media.player; import javax.microedition.media.control.videocontrol; 2. Erstellen Sie die Variablen Player, VideoControl und Field. Player videoplayer; VideoControl videocontrol; Field videofield; 3. Rufen Sie Manager.createPlayer(String) auf, indem Sie einen Parameter übergeben, der ein URI ist, der die Videoinhalte beschreibt. Speichern Sie einen Verweis auf das Player-Objekt, das durch den Aufruf von createplayer (String) zurückgegeben wird. videoplayer = Manager createplayer("file:///sdcard/blackberry/videos/soccer1.avi"); 4. Rufen Sie Player.realize() auf, damit ein Player die Informationen abrufen kann, die er zum Abrufen von Medienressourcen benötigt. videoplayer.realize(); 5. Rufen Sie Player.getControl() auf und übergeben Sie einen Parameter, der das Control-Objekt darstellt, das zurückgegeben werden soll. Wandeln Sie das zurückgegebene Objekt in ein VideoControl-Objekt um. videocontrol = (VideoControl)_videoPlayer.getControl ( "javax.microedition.media.control.videocontrol"); 9

12 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt 6. Um den Modus zu initialisieren, den ein videofield zum Anzeigen des Videos verwendet, rufen Sie VideoControl.initDisplayMode(int mode, Object arg) auf und übergeben einen arg-parameter, der den primitiven Benutzeroberflächentyp angibt, der das Video anzeigt. Wandeln Sie das zurückgegebene Objekt in ein Field- Objekt um. videofield = (Field)_videoControl.initDisplayMode ( VideoControl.USE_GUI_PRIMITIVE, "net.rim.device.api.ui.field" ); Beachten Sie, dass initdisplaymode() auf unterschiedliche Weise aufgerufen werden kann, um wie oben dargestellt ein Field zurückzugeben, ein Item zur Verwendung mit MIDlets zurückzugeben oder ein Video auf einem Canvas- Objekt anzuzeigen. Erstellen einer BlackBerry-Geräteanwendung, die ein Foto mit der Kamera aufnimmt 1. Importieren Sie die erforderlichen Klassen und Schnittstellen. import net.rim.device.api.ui.field; import javax.microedition.media.manager; import javax.microedition.media.player; import javax.microedition.media.control.videocontrol; 2. Rufen Sie Manager.createPlayer(String) auf, indem Sie einen Parameter übergeben, der ein URI ist, der die Bildinhalte beschreibt. Player cameraplayer = Manager.createPlayer( "capture://video?encoding=jpeg" ); 3. Rufen Sie Player.realize() auf, damit ein Player die Informationen abrufen kann, die er zum Abrufen von Medienressourcen benötigt. cameraplayer.realize(); 4. Rufen Sie Player.getControl() auf, indem Sie einen Parameter übergeben, der die VideoControl-Klasse darstellt. Wandeln Sie das zurückgegebene Objekt in ein VideoControl-Objekt um. VideoControl videocontrol = (VideoControl)cameraPlayer.getControl( "javax.microedition.media.control.videocontrol"); 5. Rufen Sie VideoControl.initDisplayMode(int mode, Object arg) auf, um den Modus zu initialisieren, den ein videofield zum Anzeigen des Videos verwendet. 6. Rufen Sie VideoControl.getSnapshot() auf, um ein Byte-Array mit den JPEG-Daten für das von der Kamera aufgenommene Foto aufzufüllen. int[] imagebyte = videocontrol.getsnapshot(null); Das Übergeben von Null an getsnapshot() führt zur Aufnahme eines Fotos mit den Standard-Kameraeinstellungen. Sie können den Parameter für getsnapshot() anpassen, indem Sie System.getProperty() aufrufen, um zu ermitteln, welche Einstellungen verfügbar sind. 10

13 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt String encodingstring = System.getProperty("video.snapshot.encodings"); Rufen Sie stringtokeywords() auf, um die Eigenschaften auf separate String-Array-Elemente aufzuteilen. String[] properties = StringUtilities.stringToKeywords(encodingString); Von System.getProperty() werden vier Eigenschaften zurückgegeben, auf die in dem String-Array, das von stringtokeywords() zurückgegeben wird, einzeln zugegriffen werden kann. Die Eigenschaften sind "encoding", "width", "height" und "quality". Erstellen einer BlackBerry-Geräteanwendung, die Audiodaten an ein Bluetooth-fähiges Gerät sendet 1. Importieren Sie die erforderlichen Klassen. import javax.microedition.media.control; import javax.microedition.media.manager; import javax.microedition.media.player; import net.rim.device.api.media.control.audiopathcontrol; 2. Rufen Sie Manager.createPlayer(String) auf und übergeben Sie den Speicherort einer Audiodatei. Player p = javax.microedition.media.manager createplayer(" 3. Rufen Sie Player.realize() auf, um einem Player das Abrufen von Medienressourcen zu ermöglichen. p.realize(); 4. Rufen Sie Player.prefetch() auf. p.prefetch(); 5. Rufen Sie Player.getControls() auf, um das unterstützte AudioPathControl-Objekt abzurufen. AudioPathControl apc = (AudioPathControl)p.getControl( "net.rim.device.api.media.control.audiopathcontrol" ); 6. Führen Sie eine der folgenden Aufgaben aus. Aufgabe Senden von Audiodaten an ein Bluetooth -Gerät, das Sprachanrufe unterstützt. Schritte Rufen Sie AudioPathControl.setAudioPath(int) mit dem Attribut AudioPathControl.AUDIO_PATH_BLUETOOTH als Parameter auf, um Audiodaten an das Bluetooth-Gerät zu senden. apc.setaudiopath (AudioPathControl.AUDIO_PATH_BLUETOOTH); 11

14 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt Aufgabe Senden von Audiodaten an ein Bluetooth-Gerät, das ein Bluetoothfähiges Gerät (z. B. ein Bluetooth- Stereo-Headset) unterstützt. Schritte Rufen Sie AudioPathControl.setAudioPath(int) mit dem Attribut AudioPathControl.AUDIO_ BLUETOOTH_A2DP als Parameter auf, um Audiodaten an das Bluetooth-Gerät zu senden. apc.setaudiopath(audiopathcontrol.audio_ BLUETOOTH_A2DP); Erstellen einer Content-Handler-Anwendung, die Medien wiedergibt In diesem Artikel wird beschrieben, wie mithilfe von JSR 211 eine Content-Handler-Anwendung entwickelt werden kann, um es Anwendungen zu ermöglichen, andere Anwendungen, einschließlich systemeigener BlackBerry -Geräteanwendungen, zur Verarbeitung bestimmter Inhaltstypen aufzurufen. Wenn Sie beispielsweise Ihren Content-Handler mit der Aktion SEND für die Verarbeitung von Video- oder Bildinhaltstypen registrieren, wird immer dann ein Menüelement angezeigt, wenn Sie ein Video oder Bild auf dem Kamera-Vorschaubildschirm, im Datei-Explorer usw. anzeigen. Wenn auf dieses Menüelement geklickt wird, wird Ihr Content-Handler mit einer SEND-Aktion und einem Link zum Video oder Bild aufgerufen. 1. Importieren Sie die erforderlichen Klassen. import javax.microedition.content.contenthandlerserver; import javax.microedition.content.requestlistener; import javax.microedition.content.registry; import javax.microedition.content.invocation; import javax.microedition.content.actionnamemap; 2. Erstellen Sie eine Klasse, die UiApplication erweitert und RequestListener implementiert. public final class SendMediaDemo extends UiApplication implements RequestListener 3. Behandeln Sie den Anwendungsstart. public static void main(string[] args) throws Exception if(args!= null && args.length > 0) if (args[0].equals("startup")) // Register ourselves as a content handler on startup register(); else // Create a new instance of the application and make the currently // running thread the application's event dispatching thread. SendMediaDemo app = new SendMediaDemo(); app.entereventdispatcher(); 4. Registrieren Sie die Anwendung als RequestListener. 12

15 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt public SendMediaDemo() throws ContentHandlerException // Get access to the ContentHandlerServer for this application and // register as a listener. ContentHandlerServer contenthandlerserver = Registry.getServer(CLASSNAME); contenthandlerserver.setlistener(this); 5. Erstellen Sie eine Methode für die Registrierung des Content-Handlers. Diese Methode verwendet Registry.register (), um sicherzustellen, dass diese Anwendung über externe Menüoptionen gestartet werden kann, um Videos und Bilder an diese Anwendung zu senden. private static void register() throws ContentHandlerException String[] types = "image/bmp", "image/png", "image/jpeg", "video/3gpp", "video/mp4"; String[] suffixes = ".bmp", ".png", ".jpg", ".3GP", ".mp4"; String[] actions = ContentHandler.ACTION_SEND; String[] actionnames = "Send to demo app"; ActionNameMap[] actionnamemaps = new ActionNameMap(actions,actionNames,"en"); // Get access to the registry Registry registry = Registry.getRegistry(CLASSNAME); // Register as a content handler registry.register(classname, types, suffixes, actions, actionnamemaps, ID, null); 6. Implementieren Sie RequestListener.invocationRequestNotify(). Dieser Handler wird aufgerufen, wenn eine andere Anwendung Inhalte an diese Anwendung übergibt. public void invocationrequestnotify(contenthandlerserver server) Invocation invoc = server.getrequest(false); if(invoc!= null) String type = invoc.gettype(); if(type.equals("image/bmp") type.equals("image/png") type.equals("image/jpeg")) byte[] data = getdata(invoc.geturl()); displayimage(data); else if(type.equals("video/3gpp") type.equals("video/mp4")) initvideo(invoc.geturl()); if(_videofield!= null) displayvideo(); else System.exit(0); server.finish(invoc, Invocation.OK); 13

16 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt Codebeispiel: Erstellen einer Content-Handler-Anwendung, die Medien wiedergibt package com.rim.samples.device.sendmediademo; import java.io.*; import javax.microedition.content.*; import javax.microedition.io.*; import javax.microedition.media.*; import javax.microedition.media.control.*; import javax.microedition.io.file.*; import net.rim.device.api.system.*; import net.rim.device.api.ui.*; import net.rim.device.api.ui.component.*; import net.rim.device.api.ui.container.*; public final class SendMediaDemo extends UiApplication implements RequestListener private static final String ID = "com.rim.samples.device.sendmediademo"; private static final String CLASSNAME = "com.rim.samples.device.sendmediademo.sendmediademo"; private Player _player; private Field _videofield; private VideoControl _vc; * * Entry point for application args Command line arguments public static void main(string[] args) if(args!= null && args.length > 0) if (args[0].equals("startup")) // Register ourselves as a content handler on startup register(); else // Create a new instance of the application and make the currently // running thread the application's event dispatching thread. SendMediaDemo app = new SendMediaDemo(); app.entereventdispatcher(); * * Registers this application as a content handler for image files private static void register() String[] types = "image/bmp", "image/png", "image/jpeg", "video/3gpp", "video/mp4"; 14

17 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt String[] suffixes = ".bmp", ".png", ".jpg", ".3GP", ".mp4"; String[] actions = ContentHandler.ACTION_SEND; String[] actionnames = "Send to demo app"; ActionNameMap[] actionnamemaps = new ActionNameMap(actions,actionNames,"en"); // Get access to the registry Registry registry = Registry.getRegistry(CLASSNAME); try // Register as a content handler registry.register(classname, types, suffixes, actions, actionnamemaps, ID, null); catch (ContentHandlerException che) System.out.print(che.toString()); catch (ClassNotFoundException cnfe) System.out.print(cnfe.toString()); // Constructor public SendMediaDemo() try // Get access to the ContentHandlerServer for this application and // register as a listener. ContentHandlerServer contenthandlerserver = Registry.getServer(CLASSNAME); contenthandlerserver.setlistener(this); catch(contenthandlerexception che) System.out.println(che.toString()); * * RequestListener implementation server The content handler server from which to request Invocation objects public void invocationrequestnotify(contenthandlerserver server) Invocation invoc = server.getrequest(false); if(invoc!= null) String type = invoc.gettype(); if(type.equals("image/bmp") type.equals("image/png") type.equals("image/jpeg")) 15

18 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt byte[] data = getdata(invoc.geturl()); displayimage(data); else if(type.equals("video/3gpp") type.equals("video/mp4")) initvideo(invoc.geturl()); if(_videofield!= null) displayvideo(); else System.exit(0); server.finish(invoc, Invocation.OK); * * Sets the size of the video width Width of the video display height Height of the video display private void setvideosize(int width, int height) try if (_vc!= null) _vc.setdisplaysize(width, height); catch(mediaexception pe) System.out.println(pe.toString()); * * Creates and initializes a video player url The URL of the video file to play private void initvideo(string url) try _player = javax.microedition.media.manager.createplayer(url); _player.realize(); _vc = (VideoControl) _player.getcontrol("videocontrol"); if (_vc!= null) _videofield = (Field) _vc.initdisplaymode (VideoControl.USE_GUI_PRIMITIVE, "net.rim.device.api.ui.field"); 16

19 Erstellen einer BlackBerry-Geräteanwendung, die Medien wiedergibt _vc.setvisible(true); catch(mediaexception pe) System.out.println(pe.toString()); catch (IOException ioe) System.out.println(ioe.toString()); * * Returns a byte array containing data representing the image at the specified URL url The location of the image to display The image data private byte[] getdata(string url) byte[] data = new byte[0]; try FileConnection file = (FileConnection)Connector.open(url); int filesize = (int)file.filesize(); data = new byte[filesize]; InputStream inputstream = file.openinputstream(); inputstream.read(data); catch(exception e) System.out.println(e.toString()); return data; * * Creates a screen and displays the image data The data representing the image to be rendered private void displayimage(byte [] data) // Create image field Bitmap image = Bitmap.createBitmapFromBytes( data, 0, -1, 5); BitmapField imagefield = new BitmapField( image, Field.FIELD_HCENTER); // Create and display screen MainScreen screen = new MainScreen(net.rim.device.api.ui.Manager.NO_VERTICAL_SCROLL); screen.settitle("send Media Demo"); screen.add(imagefield); pushscreen(screen); 17

20 * * Creates a video screen and starts the video player private void displayvideo() // Create and display screen VideoMainScreen screen = new VideoMainScreen(); screen.settitle("send Media Demo"); screen.add(_videofield); pushscreen(screen); try // Start media player _player.start(); catch(mediaexception pe) System.out.println(pe.toString()); * * A main screen in which to play video files final private class VideoMainScreen extends MainScreen // Constructor VideoMainScreen() super(net.rim.device.api.ui.manager.no_vertical_scroll); * net.rim.device.api.ui.manager#sublayout(int,int) protected void sublayout(int width, int height) setvideosize(display.getwidth(), Display.getHeight()); super.sublayout(width, height); * net.rim.device.api.ui.screen#onclose() public boolean onclose() _player.close(); return super.onclose(); 18

21 Festlegen der Funktionen einer BlackBerry-Geräteanwendung, die Medien wiedergibt Festlegen der Funktionen einer BlackBerry-Geräteanwendung, die Medien wiedergibt Abfragen der von einer BlackBerry-Geräteanwendung unterstützten Funktionen zur Medienwiedergabe Ihre BlackBerry -Geräteanwendung kann verschiedene Wiedergabefunktionen abfragen, zu denen der Videoanzeigemodus, die Position des Videos in Bezug auf die Bildschirm-Canvas, die x- und y-koordinaten des Videos in Bezug auf das Benutzeroberflächenobjekt zur Videoanzeige sowie Audiopegel gehören. Festlegen der Parameter für die Videowiedergabe innerhalb einer BlackBerry- Geräteanwendung 1. Importieren Sie die erforderlichen Klassen. import javax.microedition.media.manager; import javax.microedition.media.player; import javax.microedition.media.control.videocontrol; 2. Initialisieren Sie eine Instanz eines Player-Objekts und bereiten Sie diese vor. Player player = Manager.createPlayer("file:///SDCard/BlackBerry/videos/myvid.mp4"); player.realize(); 3. Rufen Sie das Videosteuerelement ab. VideoControl videocontrol = (VideoControl) player.getcontrol("videocontrol"); videocontrol.initdisplaymode(videocontrol.use_direct_video, this); 4. Um das Videosteuerelement in der Canvas einzubetten, geben Sie die Eigenschaften des Videosteuerelements an. videocontrol.setdisplaylocation(20, 30); videocontrol.setdisplaysize(160, 90); videocontrol.setvisible(true); 5. Die VideoControl-Schnittstelle wird implementiert, um eine BlackBerry -Geräteanwendung mit verschiedenen Funktionen zur Unterstützung der Videowiedergabe auszustatten. Führen Sie eine der folgenden Aktionen aus: Steuern Sie den Videoanzeigemodus mithilfe von USE_GUI_PRIMITIVE oder USE_DIRECT_VIDEO. Steuern Sie die Position des Videos in Bezug auf die Canvas, auf der das Video angezeigt wird. Greifen Sie auf die x- und die y-koordinate des Videos in Bezug auf das Benutzeroberflächenobjekt zu, das das Video anzeigt oder ausblendet. 19

22 Reagieren auf Benutzereingaben Festlegen der Lautstärke, mit der eine BlackBerry-Geräteanwendung Medien wiedergibt 1. Importieren Sie die erforderlichen Klassen. import net.rim.device.api.ui.screen; import javax.microedition.lcdui.canvas; import javax.microedition.media.control.volumecontrol; 2. Legen Sie die Lautstärke der Medienanwendung fest. VolumeControl volume = (VolumeControl) player.getcontrol("volumecontrol"); volume.setlevel(80); 3. Führen Sie eine der folgenden Aufgaben aus. Aufgabe Erfassen von Lautstärketasten-Ereignissen in einer MIDP-Anwendung. Erfassen von Lautstärketasten-Ereignissen in einer BlackBerry - Geräteanwendung. Implementieren von KeyListener zur Erfassung und Behandlung von Tastenereignissen in einer BlackBerry - Geräteanwendung. Schritte a. Erstellen Sie eine Klasse, die die Canvas-Klasse erweitert. b. Überschreiben Sie die Canvas.keyPressed()-Methode. a. Erstellen Sie eine Klasse, die die Screen-Klasse erweitert. b. Überschreiben Sie Screen.keyControl(). Erstellen Sie eine Klasse, die KeyListener implementiert, und implementieren Sie keychar(), keystatus(), keydown(), keyrepeat() und keyup (). Verwenden Sie keydown(), um das Drücken von Lautstärketasten auf BlackBerry-Geräten mit Medientasten zu verarbeiten. Reagieren auf Benutzereingaben Empfangen einer Benachrichtigung, wenn ein Benutzer eine Medientaste auf einem BlackBerry-Gerät drückt Eine BlackBerry -Geräteanwendung kann mithilfe der KeyListener-Schnittstelle Tastenereignisse abonnieren. KeyListener empfängt alle Tastenereignisse, wenn sich die Anwendung im Vordergrund befindet, und unbehandelte globale Tastenereignisse, wenn sich die Anwendung im Hintergrund befindet. 20

23 Reagieren auf Benutzereingaben Zu den Medientasten gehören "Lautstärke erhöhen", "Lautstärke verringern", "Vorwärts", "Rückwärts" und eine Kombinationstaste für Stummschaltung, Wiedergabe und Pause. Einige BlackBerry-Geräte verfügen über zusätzliche dedizierte Medientasten, zu denen Keypad.KEY_FORWARD und Keypad.KEY_BACKWARD gehören. Das Vorhandensein dieser Medientasten kann mithilfe von Keypad.hasMediaKeys() ermittelt werden. Einige BlackBerry-Geräte verfügen zudem über eine Stummschalttaste, während andere eine Freisprechanlage-Taste aufweisen. Beiden Tasten ist dieselbe Tastenkonstante, Keypad.KEY_SPEAKERPHONE, zugewiesen. Um zu bestimmen, ob es sich bei einem Tastendruck von KEY_SPEAKERPHONE um einen Druck auf die Stummschalttaste oder die Freisprechanlage-Taste handelt, verwenden Sie Keypad.hasMuteKey(). 1. Importieren Sie die erforderliche Klasse und Schnittstelle. import net.rim.device.api.ui.keypad; import net.rim.device.api.ui.container.mainscreen; 2. Erstellen Sie eine Klasse, die MainScreen erweitert, KeyListener implementiert und den Listener mit addkeylistener() registriert. class KeyListenerDemo extends MainScreen implements KeyListener public KeyListenerDemo() addkeylistener(this); Reagieren auf das Drücken einer Lautstärketaste durch einen BlackBerry-Gerätebenutzer 1. Importieren Sie die erforderlichen Klassen. import net.rim.device.api.ui.screen; import net.rim.device.api.system.characters; 2. Erstellen Sie eine Klasse, die die Screen-Klasse erweitert. 3. Überschreiben Sie Screen.keyControl(). protected boolean keycontrol(char c, int status, int time) 4. Identifizieren Sie die Lautstärketaste, die vom BlackBerry-Gerätebenutzer betätigt wird. if (c == Characters.CONTROL_VOLUME_UP) else if (c == Characters.CONTROL_VOLUME_DOWN) Anmerkung: In der net.rim.device.api.media.mediakeylistener-klasse werden die Methoden keydown(), keyrepeat() und keyup() mit Keypad.KEY_VOLUME_UP und Keypad.KEY_VOLUME_DOWN aufgerufen, was im Vergleich zur Verwendung von keychar() eine präzisere Steuerung ermöglicht. Reagieren auf eine Statusänderung eines Player-Objekts 1. Importieren Sie die erforderlichen Klassen. 21

24 Media-Streaming in einer BlackBerry-Geräteanwendung import javax.microedition.media.player; import javax.microedition.media.playerlistener; import javax.microedition.media.mediaexception; import java.io.ioexception; 2. Rufen Sie addplayerlistener() auf, um Änderungen des Status des Player-Objekts zu empfangen. private void doplay() throws IOException, MediaException Player p = Manager.createPlayer("file:///SDCard/BlackBerry/music/theo.mp3"); p.addplayerlistener(this); p.realize(); p.prefetch(); p.start(); 3. Überschreiben Sie playerupdate(), um ein Medienereignis an den registrierten PlayerListener zu senden. public void playerupdate(player player, final String event, Object eventdata) if (event.equals(volume_changed)) else if (event.equals(started )) else if (event.equals(stopped)) else if (event.equals(duration_updated)) else if (event.equals(end_of_media)) //Add code for actions if the end of media is reached. //Release resources when end of media event is received player.close(); Media-Streaming in einer BlackBerry-Geräteanwendung Um Daten von einer Remote-Quelle per Streaming an eine BlackBerry -Geräteanwendung zu übertragen, müssen Sie die Quelle puffern und steuern, wie die Medienanwendung die Daten liest. Erweitern Sie DataSource und erstellen Sie eine benutzerdefinierte Implementierung von SourceStream, um Daten an die Medienanwendung zu senden. RIMM-Streaming-Videodatei Das proprietäre RIM-Videoformat (RIMM-Streaming-Datei) besteht aus einer Kopfzeile, einer Liste von Frames und einer Fußzeile. Die Datei enthält auch einen Deskriptor, der zusätzliche Metadaten speichert. Die Position dieses Deskriptors hängt vom Aufzeichnungsziel ab. Wenn das Aufzeichnungsziel eine Datei ist, befindet sich der Deskriptor am Ende der Kopfzeile vor der Liste der Frames. Wenn das Aufzeichnungsziel ein Stream ist, befindet sich der Deskriptor hinter der Liste der Frames in der Fußzeile. 22

25 Media-Streaming in einer BlackBerry-Geräteanwendung Proprietäres RIM-Videoformat (RIMM-Streaming-Datei) Das proprietäre RIM-Videoformat besteht aus einer Kopfzeile, einer Liste von Frames und einer Fußzeile. Beim Parsing dieser Datei müssen Sie die Werte vom Typ int oder short von Little-Endian in Big-Endian übersetzen. Kopfzeile Feld Wert Größe ID-Tag RIMM 4 B Version 0 3 B Deskriptorposition 0 beim Aufzeichnen in einer Datei 1 B 1 beim Aufzeichnen in einem Stream Deskriptor Deskriptorwerte 79 B beim Aufzeichnen in einer Datei Frames 0 B beim Aufzeichnen in einem Stream Feld Wert Größe Stream-Typ 0, wenn es sich um einen Audioframe handelt 1, wenn es sich um einen Videoframe handelt Schlüsselframe 1, wenn es sich um einen Schlüsselframe handelt andernfalls 0 Konfigurationsframe 1, wenn es sich um einen Konfigurationsframe handelt andernfalls 0 Größe Framegröße in Byte 30 b Dauer Länge des Videos in Millisekunden 2 B Daten Die eigentlichen Framedaten <Größe> B Stream-Typ 0, wenn es sich um einen Audioframe handelt 1 B 1 B 1 b 1 b 23

26 Media-Streaming in einer BlackBerry-Geräteanwendung Feld Wert Größe 1, wenn es sich um einen Videoframe handelt Schlüsselframe 1, wenn es sich um einen Schlüsselframe handelt andernfalls 0 Konfigurationsframe 1, wenn es sich um einen Konfigurationsframe handelt andernfalls 0 Größe Framegröße in Byte 30 b Dauer Länge des Videos in Millisekunden 2 B Anmerkung: Das Schlüsselframe-, das Konfigurationsframe- und das Größenfeld werden in einer 32-Bit-int-Ganzzahl gespeichert, wobei das Schlüsselframe- und das Konfigurationsframefeld in den ersten beiden Bit gespeichert werden. Fußzeile 1 b 1 b Feld Wert Größe Deskriptor Deskriptorwerte 79 Byte beim Aufzeichnen in einem Stream 0 Byte beim Aufzeichnen in einer Datei Deskriptor Feld Wert Größe Audioframes Anzahl der Audioframes 4 B Videoframes Anzahl der Videoframes 4 B Audio- Anzahl der Audio-Schlüsselframes 4 B Schlüsselframes Video- Anzahl der Video-Schlüsselframes 4 B Schlüsselframes Audio-Frameraten Anzahl der Audio-Frameraten (Anzahl der 4 B Frameratenänderungen + 1) Video-Frameraten Anzahl der Video-Frameraten (Anzahl der 4 B Frameratenänderungen + 1) Audiogröße Größe des Audiostreams in Byte 4 B 24

27 Media-Streaming in einer BlackBerry-Geräteanwendung Feld Wert Größe Videogröße Größe des Videostreams in Byte 4 B Video-Framerate Die anfängliche Video-Framerate in Frames pro 4 B Sekunde Max. Größe des größten Videoframes in Byte 4 B Videoframegröße Audiodauer Länge des Audiostreams in Millisekunden 4 B Videodauer Länge des Videostreams in Millisekunden 4 B RESERVIERT Nicht definiert 20 B Breite Die Breite des Videos in Pixeln 2 B Höhe Die Höhe des Videos in Pixeln 2 B Video-Codec 2, wenn dieser Video-Codec mpeg4 ist 2 B 5, wenn dieser Video-Codec H.263 ist 6, wenn dieser Video-Codec H.264 ist Audio-Codec 0, wenn dieser Audio-Codec PCM ist 7, wenn dieser Audio-Codec AMR ist 0xA, wenn dieser Audio-Codec AAC ist 1 B Puffern und Wiedergeben von per Streaming übertragenen Medieninhalten Mithilfe der Multimedia-API können Sie eine benutzerdefinierte Klasse erstellen, die javax.microedition.media.protocol.datasource erweitert, um anzupassen, wie Daten vom Media Player des BlackBerry -Geräts aus Ihrer Anwendung gelesen werden. DataSource stellt eine SourceStream-Implementierung bereit, die SourceStream.read() zum Übertragen von Daten verwendet. 1. Importieren Sie die erforderlichen Klassen und Schnittstellen. import java.lang.thread; import java.io.inputstream; import java.io.outputstream; import javax.microedition.media.protocol.datasource; import javax.microedition.media.protocol.sourcestream; import javax.microedition.io.contentconnection; import javax.microedition.io.file.fileconnection; import net.rim.device.api.io.sharedinputstream; 2. Erstellen Sie eine benutzerdefinierte Klasse, die die abstrakte javax.microedition.media.protocol.datasource-klasse erweitert. public final class LimitedRateStreamingSource extends DataSource 25

28 Media-Streaming in einer BlackBerry-Geräteanwendung 3. Deklarieren Sie Instanzfelder, die Sie für Ihre DataSource-Implementierung benötigen. Die folgenden Felder stammen aus dem Beispielprojekt "bufferedplaybackdemo". * The stream connection over which media content is passed private ContentConnection _contentconnection; * An input stream shared between several readers private SharedInputStream _readahead; * A stream to the buffered resource private LimitedRateSourceStream _feedtoplayer; * The MIME type of the remote media file private String _forcedcontenttype; * The thread which retrieves the remote media file private ConnectionThread _loaderthread; * The local save file into which the remote file is written private FileConnection _savefile; * A stream for the local save file private OutputStream _savestream; 4. Erstellen Sie einen Konstruktor für Ihre benutzerdefinierte Klasse. LimitedRateStreamingSource(String locator) super(locator); 5. Implementieren Sie javax.microedition.media.protocol.datasource.connect(). Mit dieser Methode wird eine Verbindung zu der vom Locator beschriebenen Quelle hergestellt und die Kommunikation eingeleitet. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". public void connect() throws IOException 6. Implementieren Sie javax.microedition.media.protocol.datasource.disconnect(). Mit dieser Methode wird die Verbindung zu der vom Locator beschriebenen Quelle getrennt und die zur Aufrechterhaltung der Verbindung verwendeten Ressourcen werden freigegeben. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". public void disconnect() 7. Implementieren Sie javax.microedition.media.protocol.datasource.getcontenttype(). Mit dieser Methode wird ein String abgerufen, der den Inhaltstyp der Medien beschreibt, die von der Quelle bereitgestellt werden. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". public String getcontenttype() return _feedtoplayer.getcontentdescriptor().getcontenttype(); 8. Implementieren Sie javax.microedition.media.protocol.datasource.getstreams(). Mit dieser Methode wird eine Sammlung von Streams abgerufen, die von dieser Quelle verwaltet werden. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". 26

29 Media-Streaming in einer BlackBerry-Geräteanwendung public SourceStream[] getstreams() return new SourceStream[] _feedtoplayer ; 9. Implementieren Sie javax.microedition.media.protocol.datasource.start(). Mit dieser Methode wird die Datenübertragung eingeleitet. Sie muss aufgerufen werden, bevor Daten zum Lesen verfügbar sind. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". public void start() throws IOException if (_savestream!= null) _loaderthread = new ConnectionThread(); _loaderthread.start(); 10. Implementieren Sie javax.microedition.media.protocol.datasource.stop(). Mit dieser Methode wird die Datenübertragung beendet. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". public void stop() throws IOException // Set the boolean flag to stop the thread _stop = true; 11. Erstellen Sie eine Klasse, die javax.microedition.media.protocol.sourcestream implementiert. In diesem Beispiel wird eine innere Klasse verwendet, um einen Stream für die gepufferte Medienressource bereitzustellen. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". private final class LimitedRateSourceStream implements SourceStream 12. Implementieren Sie getseektype(), um zurückzugeben, ob Medien während der Wiedergabe durchsuchbar sind. public int getseektype() return SEEKABLE_TO_START; 13. Implementieren Sie innerhalb dieser inneren Klasse javax.microedition.media.protocol.sourcestream.read(). Mit dieser Methode werden Daten aus dem Eingabestream in ein Byte-Array eingelesen. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". public int read(byte[] bytes, int off, int len) throws IOException 14. Sie sollten innerhalb dieser inneren Klasse auch seek(), tell() und close() implementieren. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". 15. Schließen Sie die innere Klasse ab und erstellen Sie eine weitere innere Klasse, die java.lang.thread erweitert. Verwenden Sie diese beim Erstellen eines Threads, um die Remote-Datei herunterzuladen und sie in die lokale Datei zu schreiben. Weitere Informationen finden Sie im Beispielprojekt "bufferedplaybackdemo". private final class ConnectionThread extends Thread 27

30 Media-Streaming in einer BlackBerry-Geräteanwendung Codebeispiel: Media-Streaming in einer BlackBerry-Geräteanwendung * * A thread which downloads the remote file and writes it to the local file * From bufferedplaybackdemo\limitedratestreamingsource.java private final class ConnectionThread extends Thread * * Download the remote media file, then write it to the local file. public void run() try byte[] data = new byte[read_chunk]; int len = 0; // Until we reach the end of the file while (-1!= (len = _readahead.read(data))) _totalread += len; if (!_bufferingcomplete && _totalread > getstartbuffer()) // We have enough of a buffer to begin playback _bufferingcomplete = true; System.out.println("Initial Buffering Complete"); // updateloadstatus("buffering Complete"); if (_stop) // Stop reading return; System.out.println("Downloading Complete"); System.out.println("Total Read: " + _totalread); // If the downloaded data is not the same size // as the remote file, something is wrong. if (_totalread!= _contentconnection.getlength()) System.err.println("* Unable to Download entire file *"); _downloadcomplete = true; _readahead.setcurrentposition(0); // Write downloaded data to the local file while (-1!= (len = _readahead.read(data))) _savestream.write(data); catch (Exception e) System.err.println(e.toString()); 28

31 Media-Streaming in einer BlackBerry-Geräteanwendung Codebeispiel: Lesen von Daten aus einem Puffer Wenn die Medienanwendung alle Daten im Puffer liest, kann die BlackBerry -Geräteanwendung von der Medienanwendung gesendete Leseanforderungen blockieren, bis mehr Daten gepuffert wurden. Halten Sie Lesevorgänge an, um sicherzustellen, dass im Puffer die festgelegte Menge von Audiodaten für die Wiedergabe vorhanden ist. public int read(byte[] b, int off, int len) throws IOException // Read from a SharedInputStream that is shared // with the same Stream that the ConnectionThread // is downloading to. Although both streams handle // the same data, each stream has a separate read location. // The ConnectionThread works to keep its read location // as far ahead of the current playback position as possible. System.out.println("Read Request for: " + len + " bytes"); // limit bytes read to our readlimit. int readlength = len; if (readlength > getreadlimit()) readlength = getreadlimit(); int available; boolean restart_pause = false; for (;;) * A read action is be restricted by the amount of data * available for a read operation. The application needs * to download a specific amount of data before the * application can start to playback audio. * Enough data must be available to perform a full read * operation. In this sample, the application configures * the amount of data that is required to start the playback * of audio and to perform a read operation. The application * uses the ReadLimit value to control the amount of data * the second readerreads during a read operation. * * The application uses the PauseBytes setting to determine * when the second reader has read all the data currently * provided by the first variable reader. When this occurs, * the application pauses until there is enough data in the * buffer for a read operation. * * The application uses the RestartBytes setting to define * when there is enough data in the buffer to perform a * read operation. available = _basesharedstream.available(); if (downloadcomplete) 29