Die von der Kamera erkannte Menge an Bewegung. Die zulässigen Werte liegen zwischen 0 (keine erfasste Bewegung) und 100 (sehr starke Bewegung). Anhand des Werts dieser Eigenschaft können Sie ermitteln, ob eine Einstellung für die setMotionLevel()-Methode übergeben werden muss.

Wenn die Kamera verfügbar ist, aufgrund eines nicht erfolgten Video.attachCamera()-Aufrufs noch nicht verwendet wird, wird diese Eigenschaft auf -1 gesetzt.

Beim Streaming ausschließlich unkomprimierter lokaler Videos wird diese Eigenschaft nur dann gesetzt, wenn der Ereignisprozedur eine Funktion zugewiesen wurde. Andernfalls ist diese Eigenschaft nicht definiert.

Siehe auch

Die Bandbreite (in Byte), die für den momentan ausgehenden Videofeed maximal zur Verfügung steht. Der Wert 0 bedeutet, dass der Feed die zur Beibehaltung der gewünschten Bildqualität erforderliche Bandbreite für Videos nutzen kann.

Legen Sie diese Eigenschaft über die setQuality()-Methode fest.

Siehe auch

Die Abtastrate in Bildern pro Sekunde, mit der die Kamera Daten erfasst. Diese Eigenschaft kann nicht eingestellt werden. Mit der setMode()-Methode können Sie jedoch die verwandte Eigenschaft fps festlegen, welche die maximale Bildrate angibt, mit der die Kamera Daten erfassen soll.

Siehe auch

Die maximal Rate in Bildern pro Sekunde, mit der die Kamera Daten erfassen kann. Die höchstmögliche Rate richtet sich nach den Möglichkeiten der Kamera; diese Bildrate wird möglicherweise nicht erzielt.

• Über die setMode()-Methode können Sie den gewünschten Wert für diese Eigenschaft festlegen.
• Verwenden Sie die currentFPS-Eigenschaft, um festzustellen, mit welcher Abtastrate die Kamera derzeit Daten erfasst.

Siehe auch

Die aktuelle Aufnahmebildhöhe in Pixel. Über die setMode()-Methode können Sie einen Wert für diese Eigenschaft festlegen.

Siehe auch

Eine auf null basierende Ganzzahl, die den Index der Kamera anhand des von der names-Eigenschaft zurückgegebenen Arrays angibt.

Siehe auch

Die Anzahl der Videobilder, die vollständig übertragen (so genannte Schlüsselbilder) und nicht mit dem Algorithmus zur Videokomprimierung interpoliert werden. Der Standardwert ist 15, d. h., jedes fünfzehnte Bild ist ein Schlüsselbild. Der Wert 1 bedeutet, dass jedes Bild ein Schlüsselbild ist. Zulässige Werte sind Zahlen von 1 bis 48.

Siehe auch

Gibt an, ob eine lokale Wiedergabe der Kameraaufnahmen wie bei der Live-Übertragung mit Flash Media Server komprimiert und dekomprimiert (true) oder nicht komprimiert (false) wird. Der Standardwert lautet false.

Obwohl ein komprimierter Stream für Testzwecke nützlich ist, beispielsweise bei der Vorschau der Einstellungen für die Videoqualität, entsteht dadurch ein erheblicher Verarbeitungsaufwand. Die lokale Ansicht wird komprimiert und für die Übertragung bearbeitet wie in einer Live-Verbindung und dann für die lokale Anzeige dekomprimiert.

Um diesen Wert einzustellen, verwenden Sie Camera.setLoopback(). Wenn diese Eigenschaft auf "true" gesetzt ist, können Sie den Komprimierungsgrad über Camera.setQuality() festlegen.

Siehe auch

Die erforderliche Bewegungsstärke zum Auslösen des activity-Ereignisses. Die zulässigen Werte liegen zwischen 0 und 100. Der Standardwert ist 50.

Videos können unabhängig vom Wert der Eigenschaft motionLevel wiedergegeben werden. Weitere Informationen hierzu finden Sie unter setMotionLevel().

Siehe auch

Die Zeit in Millisekunden zwischen dem Zeitpunkt, zu dem die Kamera keine Bewegung mehr erfasst, und dem Zeitpunkt, zu dem das activity aufgerufen wird. Der Standardwert lautet 2000 (2 Sekunden).

Legen Sie diesen Wert über die setMotionLevel()-Methode fest.

Siehe auch

Ein boolescher Wert, der angibt, ob der Benutzer im Flash Player-Dialogfeld "Zugriffsschutz" den Zugriff auf die Kamera verweigert (true) oder gewährt (false) hat. Wenn sich dieser Wert ändert, wird das status-Ereignis ausgelöst.

Siehe auch

Der Name der aktuellen Kamera, der von der Kamerahardware zurückgegeben wird.

Siehe auch

Ein Array mit Strings, in dem die Namen aller verfügbaren Kameras enthalten sind. Das Dialogfeld "Zugriffsschutz" von Flash Player wird nicht angezeigt. Dieses Array verhält sich ebenso wie alle anderen ActionScript-Arrays, gibt also implizit die auf null basierende Indexposition jeder Kamera und die Anzahl der Kameras im System zurück (mithilfe von names.length). Weitere Informationen finden Sie im Array-Klasseneintrag names.

Zum Aufrufen der names-Eigenschaft ist eine genaue Überprüfung der Hardware erforderlich; daher kann das Erstellen des Arrays einige Sekunden dauern. In den meisten Fällen können Sie die Standardkamera verwenden.

Siehe auch

Die erforderliche Bildqualität, die sich aus dem Grad der Komprimierung jedes Videobilds ergibt. Die zulässigen Werte liegen zwischen 1 (niedrigste Qualität, maximale Komprimierung) und 100 (höchste Qualität, keine Komprimierung). Der Standardwert ist 0, d. h., die Bildqualität kann gegebenenfalls geändert werden, damit die Bandbreite nicht überschritten wird.

Legen Sie diese Eigenschaft über die setQuality()-Methode fest.

Siehe auch

Die aktuelle Aufnahmebildbreite in Pixel. Über die setMode()-Methode können Sie den gewünschten Wert für diese Eigenschaft festlegen.

Siehe auch

Gibt eine Referenz auf ein Camera-Objekt zum Aufnehmen von Videos zurück. Um mit der Videoaufnahme zu beginnen, muss das Camera-Objekt mit einem Video-Objekt verknüpft werden (siehe Video.attachCamera() ). Wenn Sie Video an Flash Media Server übertragen möchten, rufen Sie NetStream.attachCamera() auf, um das Camera-Objekt mit einem NetStream-Objekt zu verknüpfen.

Mehrere Aufrufe der getCamera()-Methode verweisen auf denselben Kameratreiber. Wenn der Code Elemente wie firstCam:Camera = getCamera() und secondCam:Camera = getCamera() enthält, verweisen firstCam und secondCam somit auf dieselbe Kamera, bei der es sich um die Standardkamera des Benutzers handelt.

Im Allgemeinen muss kein Wert für den name-Parameter übergeben werden. Verwenden Sie einfach getCamera(), um einen Verweis auf die Standardkamera zurückzugeben. Im Bedienfeld für die Kameraeinstellungen kann der Benutzer eine Standardkamera für Flash Player angeben (Informationen hierzu weiter unten in diesem Abschnitt).

Wenn eine SWF-Datei versucht, auf die von getCamera() zurückgegebene Kamera zuzugreifen, wird in Flash Player ein Dialogfeld angezeigt, in dem der Benutzer den Zugriff auf die Kamera gewähren oder verweigern kann. (Achten Sie darauf, dass die Größe des Anwendungsfensters mindestens 215 x 138 Pixel beträgt. Dies ist die in Flash Player erforderliche Mindestgröße für die Anzeige des Dialogfelds.) Nachdem der Benutzer in diesem Dialogfeld eine Option ausgewählt hat, wird in Flash Player ein Informationsobjekt im status-Ereignis zurückgegeben, das die Auswahl des Benutzers angibt. Mit Camera.muted wird angegeben, dass der Benutzer den Zugriff auf eine Kamera verweigert hat. Mit Camera.Unmuted wird angegeben, dass der Benutzer den Zugriff auf eine Kamera gewährt hat. Über die status-Eigenschaft können Sie ohne Bearbeitung des muted-Ereignisses feststellen, ob ein Benutzer den Zugriff auf eine Kamera verweigert oder gewährt hat.

Der Benutzer kann außerdem dauerhafte Sicherheitseinstellungen für eine bestimmte Domäne vornehmen. Dazu muss er während der Wiedergabe einer SWF-Datei mit der rechten Maustaste klicken (Windows) bzw. beim Klicken die Taste <Ctrl> gedrückt halten (Macintosh), anschließend "Einstellungen" und danach im Dialogfeld "Zugriffsschutz" die Option "Speichern" wählen.

Mit ActionScript können Sie den Wert "Zulassen" oder "Verweigern" für einen Benutzer nicht ändern. Sie können jedoch durch Aufrufen von Security.showSettings(SecurityPanel.PRIVACY) das Dialogfeld "Zugriffsschutz" für den Benutzer anzeigen. Wenn ein Benutzer "Speichern" auswählt, wird er in Flash Player nicht mehr dazu aufgefordert, den Zugriff von SWF-Dateien in der Domäne auf die Kamera zu gewähren oder zu verweigern.

Wenn getCamera() den Wert null zurückgibt, wird die Kamera gerade in einer anderen Anwendung verwendet, oder im System sind keine Kameras installiert. Mithilfe der names.length-Eigenschaft können Sie feststellen, ob Kameras installiert sind. Über System.showSettings(SecurityPanel.CAMERA) können Sie das Flash Player-Bedienfeld für die Kameraeinstellungen anzeigen, in dem der Benutzer die über getCamera() verwiesene Kamera auswählen kann.

Der Suchlauf zum Überprüfen der Hardware auf installierte Kameras kann einige Zeit in Anspruch nehmen. Wenn Flash Player mindestens eine Kamera gefunden hat, wird der Suchlauf für diese Player-Instanz nicht noch einmal durchgeführt. Wenn von Flash Player jedoch keine Kameras gefunden werden, wird der Suchlauf bei jedem Aufruf von getCamera durchgeführt. Diese Funktion ist besonders hilfreich, wenn der Benutzer vergessen hat, die Kamera anzuschließen. Sofern Ihre SWF-Datei eine Schaltfläche "Wiederholen" besitzt, mit der getCamera aufgerufen wird, kann Flash Player nach der Kamera suchen, ohne dass die SWF-Datei erneut gestartet werden muss.

Parameter

Siehe auch

Gibt die Videobilder an, die vollständig übertragen (so genannte Schlüsselbilder) und nicht mit dem Algorithmus zur Videokomprimierung interpoliert werden. Diese Methode ist nur bei der Übertragung von Videos über Flash Media Server anwendbar.

Mit dem Algorithmus zur Videokomprimierung in Flash werden Videos so komprimiert, dass nur die ab dem letzten Bild eines Videos geänderten Bildbereiche übertragen werden. Diese Abschnitte werden als interpolierte Bilder bezeichnet. Bilder eines Videos können entsprechend dem Inhalt des vorherigen Bilds interpoliert werden. Bei einem Schlüsselbild handelt es sich jedoch um ein vollständiges Videobild, das nicht aus vorherigen Bildern interpoliert wurde.

Berücksichtigen Sie zum Festlegen eines Werts für den keyFrameInterval-Parameter die Bandbreitennutzung und den Zugriff auf die Videowiedergabe. Durch die Angabe eines höheren Werts für keyFrameInterval (weniger häufiges Senden von Schlüsselbildern) wird beispielsweise die Bandbreitennutzung verringert. Dadurch wird jedoch möglicherweise die erforderliche Zeit zum Positionieren des Abspielkopfes an einem bestimmten Punkt im Video erhöht. Unter Umständen muss eine höhere Anzahl Videobilder interpoliert werden, damit die Wiedergabe des Videos fortgesetzt werden kann.

Durch die Angabe eines niedrigen Werts für keyFrameInterval (häufiges Senden von Schlüsselbildern) wird dagegen die Bandbreitennutzung erhöht, da häufiger vollständige Videobilder übertragen werden. Gleichzeitig wird möglicherweise jedoch die erforderliche Zeit zum Suchen eines bestimmten Videobilds in einem aufgenommenen Video verringert.

Parameter

Siehe auch

Gibt an, ob ein komprimierter Video-Stream für die lokale Wiedergabe der Kamera verwendet wird. Diese Methode kann nur bei der Übertragung von Videos mit Flash Media Server angewendet werden. Durch Setzen von compress auf true kann präziser angezeigt werden, wie ein Video bei der Wiedergabe in Echtzeit wiedergegeben wird.

Obwohl ein komprimierter Stream für Testzwecke nützlich ist, beispielsweise bei der Vorschau der Einstellungen für die Videoqualität, entsteht dadurch ein erheblicher Verarbeitungsaufwand. Die lokale Wiedergabe wird nicht einfach nur komprimiert, sie wird komprimiert, wie bei einer Live-Verbindung für die Übertragung bearbeitet und dann für die lokale Wiedergabe dekomprimiert.

Wenn Sie compress auf true setzen, können Sie die Stärke der Komprimierung über Camera.setQuality() festlegen.

Parameter

Siehe auch

Legt als Kameraaufnahmemodus den systemeigenen Modus fest, mit dem die angegebenen Kriterien am besten erfüllt werden. Wenn die Kamera über keinen systemeigenen Modus verfügt, der mit allen übergebenen Parametern übereinstimmt, wird in Flash Player ein Aufnahmemodus ausgewählt, der dem gewünschten Modus am ehesten entspricht. Bei diesem Vorgang werden möglicherweise Teile des Videobilds abgeschnitten sowie Bilder übersprungen.

Standardmäßig überspringt Flash Player Bilder, sofern dies zum Beibehalten der gewünschten Bildgröße erforderlich ist. Um die Anzahl der übersprungenen Bilder zu minimieren, auch wenn dazu ggf. die Bildgröße reduziert werden muss, übergeben Sie den Wert false für den Parameter favorArea.

Bei Auswahl eines systemeigenen Modus wird in Flash Player versucht, das gewünschte Bildseitenverhältnis möglichst beizubehalten. Wenn Sie beispielsweise den Befehl myCam.setMode(400, 400, 30) ausgeben und die maximalen Werte der Kamera für Breite und Höhe 320 und 288 betragen, werden in Flash Player sowohl die Breite als auch die Höhe auf den Wert 288 gesetzt. So wird in Flash Player das gewünschte Bildseitenverhältnis von 1:1 beibehalten.

Wenn Sie überprüfen möchten, welche Werte diesen Eigenschaften zugewiesen wurden, nachdem in Flash Player der Modus ausgewählt wurde, der den gewünschten Werten am nächsten kommt, verwenden Sie die Eigenschaften width, height und fps.

Wenn Sie Flash Media Server verwenden, können Sie auch einzelne Frames erfassen oder Zeitrafferaufnahmen erstellen. Weitere Informationen finden Sie unter NetStream.attachCamera().

Parameter

Siehe auch

Gibt die erforderliche Bewegungsstärke zum Auslösen des activity-Ereignisses an. Gibt optional die Zeit in Millisekunden an, die ohne Aktivität vergehen muss, bevor in Flash Player keine Bewegung mehr festgestellt und das Ereignis ausgelöst wird.

Hinweis: Videos können unabhängig vom Wert des motionLevel-Parameters wiedergegeben werden. Dieser Parameter legt nur fest, wann und unter welchen Umständen das Ereignis ausgelöst wird, nicht jedoch, ob tatsächlich Videodaten aufgezeichnet oder wiedergegeben werden.

Wenn die Kamera überhaupt keine Bewegung erkennen soll, legen Sie für den motionLevel-Parameter den Wert 100 fest. Das activity-Ereignis wird dann nie ausgelöst. (Dieser Wert wird wahrscheinlich nur für Testzwecke verwendet, beispielsweise um vorübergehend alle Prozeduren zu deaktivieren, die bei diesem Ereignis normalerweise ausgelöst werden.)

Über die activityLevel-Eigenschaft können Sie feststellen, welche Bewegungsstärke derzeit mit der Kamera erkannt wird. Die Bewegungstoleranzwerte entsprechen direkt den Aktivitätswerten. Völliges Fehlen von Bewegung entspricht dem Aktivitätswert 0. Ständige Bewegung entspricht dem Aktivitätswert 100. Bei fehlender Bewegung ist der Aktivitätswert niedriger als die Bewegungstoleranz, bei Bewegung übersteigen die Aktivitätswerte häufig die Bewegungstoleranz.

Diese Methode ähnelt Microphone.setSilenceLevel(). Mit beiden Methoden wird angegeben, zu welchem Zeitpunkt das activity-Ereignis ausgelöst werden soll. Diese Methoden haben jedoch deutlich unterschiedliche Auswirkungen auf das Veröffentlichen von Streams:

• Microphone.setSilenceLevel() dient zur Optimierung der Bandbreite. Wenn ein Audio-Stream als lautlos eingestuft wird, werden keine Audiodaten gesendet. Stattdessen wird eine Meldung gesendet, um den Beginn der Inaktivität (Stille) anzuzeigen.
• Camera.setMotionLevel() ist dazu bestimmt, Bewegung festzustellen und hat keinen Einfluss auf die Bandbreitenauslastung. Auch wenn ein Video-Stream keine Bewegung feststellt, werden weiterhin Videodaten gesendet.

Parameter

Siehe auch

Legt die maximale Bandbreite pro Sekunde oder die erforderliche Bildqualität des aktuell ausgehenden Videofeeds fest. Diese Methode ist in der Regel nur bei der Übertragung von Videos über Flash Media Server anwendbar.

Mit dieser Methode können Sie festlegen, ob die Ausnutzung der Bandbreite oder die Bildqualität des ausgehenden Videofeeds für die Anwendung Vorrang haben soll.

• Soll die Ausnutzung der Bandbreite Vorrang haben, geben Sie einen Wert für bandwidth an und belegen quality mit dem Wert 0. Flash Player überträgt Video dann innerhalb der angegebenen Bandbreite mit der bestmöglichen Qualität. Die Bildqualität wird von Flash Player gegebenenfalls verringert, um eine Überschreitung der angegebenen Bandbreite zu verhindern. Allgemein gilt, dass bei stärkerer Bewegung die Qualität abnimmt.
• Soll die Qualität Vorrang haben, belegen Sie bandwidth mit dem Wert 0 und geben für quality einen numerischen Wert an. Flash Player verwendet dann so viel Bandbreite, wie zum Beibehalten der angegebenen Qualität erforderlich ist. Die Bildrate wird von Flash Player gegebenenfalls verringert, um die Bildqualität beizubehalten. Allgemein gilt, dass sich bei stärkerer Bewegung auch die Nutzung der Bandbreite erhöht.
• Übergeben Sie numerische Werte für beide Parameter, um anzugeben, dass Bandbreite und Bildqualität gleichermaßen wichtig sind. Flash Player überträgt Video mit der angegebenen Qualität, ohne die angegebene Bandbreite zu überschreiten. Die Bildrate wird von Flash Player gegebenenfalls verringert, um die Bildqualität ohne Überschreiten der angegebenen Bandbreite beizubehalten.

Parameter

Siehe auch

Wird ausgelöst, wenn die Sitzung einer Kamera gestartet oder beendet wird. Rufen Sie Camera.setMotionLevel() auf, um festzulegen, wie viel Bewegung nötig ist, damit ein activity-Ereignis mit einem activating-Wert von true ausgelöst wird, oder um festzulegen, wie viel Zeit ohne Aktivität vergehen muss, bevor ein activity-Ereignis mit einem activating-Wert von false ausgelöst wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn der Status einer Kamera protokolliert wird. Wenn der Wert der code-Eigenschaft auf "Camera.muted" gesetzt ist, hat der Benutzer den Zugriff der SWF-Datei auf die Kamera verweigert. Wenn der Wert der code-Eigenschaft auf "Camera.Unmuted" gesetzt ist, hat der Benutzer den Zugriff der SWF-Datei auf die Kamera gewährt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Siehe auch

Hinweis: Dieses Beispiel kann nur dann korrekt nachvollzogen werden, wenn eine Kamera mit dem Computer verbunden ist.

package {
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    import flash.events.*;
    import flash.media.Camera;
    import flash.media.Video;

    public class CameraExample extends Sprite {
        private var video:Video;
        
        public function CameraExample() {
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var camera:Camera = Camera.getCamera();
            
            if (camera != null) {
                camera.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
                video = new Video(camera.width * 2, camera.height * 2);
                video.attachCamera(camera);
                addChild(video);
            } else {
                trace("You need a camera.");
            }
        }
        
        private function activityHandler(event:ActivityEvent):void {
            trace("activityHandler: " + event);
        }
    }
}