Image, Audio und Video Extender Verwaltung und Programmierung

DB2Audio


Image Audio Video
  X  

Speichert den Inhalt eines Tons in einer Datenbanktabelle. Die Tonquelle kann ein Client-Puffer, eine Client-Datei oder eine Server-Datei sein. Der Ton kann in der Datenbanktabelle als BLOB oder in einer Server-Datei (auf die durch die Datenbanktabelle verwiesen wird) gespeichert werden. Die Tonquelle kann ein unterstütztes Format haben, wobei der DB2Audio Extender deren Speicherattribute identifiziert; es kann aber auch ein nicht unterstütztes Format haben, wobei die Attribute in der UDF angegeben werden müssen.

Kopfdatei

dmbaudio.h

Syntax

Speichern des Inhalts eines Puffers oder einer Client-Datei

>>-DB2Audio--(--datenbankname--,--inhalt--,--format--,---------->
 
>----zieldatei--,--kommentar--)--------------------------------><
 

Syntax

Speichern des Inhalts einer Server-Datei

>>-DB2Audio--(--datenbankname--,--quellendatei--,--format--,--speichertyp--,-->
 
>---kommentar--)-----------------------------------------------><
 

Syntax

Speichern des Inhalts eines Puffers oder einer Client-Datei mit vom Benutzer angegebenen Attributen

>>-DB2Audio--(--datenbankname--,--inhalt--,--zieldatei--,------->
 
>----kommentar--,--attribute--)--------------------------------><
 

Syntax

Speichern des Inhalts einer Server-Datei mit vom Benutzer angegebenen Attributen

>>-DB2Audio--(--datenbankname--,--quellendatei--,--speichertyp--,--kommentar--,-->
 
>---attribute--)-----------------------------------------------><
 

Parameter (Datentyp)

datenbankname (VARCHAR(18))
Der Name der Datenbank, zu der momentan eine Verbindung besteht, wie durch das Sonderregister CURRENT SERVER angegeben.

inhalt (BLOB(2G) AS LOCATOR)
Die Host-Variable, die den Inhalt des Tons enthält. Die Host-Variable kann vom Typ BLOB, BLOB_FILE oder BLOB_LOCATOR sein. DB2 stuft den Datentyp des Inhalts in BLOB_LOCATOR um und übergibt den LOB-Zeiger an die UDF DB2Audio.

format (VARCHAR(8))
Das Format des Quellentons. Ein Nullwert oder eine leere Zeichenfolge kann angegeben werden, wobei der Audio Extender versucht, das Quellenformat automatisch zu bestimmen. Der Ton wird in dem gleichen Format gespeichert wie die Quelle. Unterstützte Audioformate befinden sich in Tabelle 4.

zieldatei (LONG VARCHAR)
Der Name der Ziel-Server-Datei (zum Speichern in eine Server-Datei) oder ein Nullwert bzw. eine leere Zeichenfolge (zum Speichern in eine Datenbanktabelle als BLOB). Die Zieldatei kann mit einem vollständig qualifizierten Namen angegeben werden. Wenn der Name nicht als vollständig qualifizierter Name angegeben wird, werden die Umgebungsvariablen DB2AUDIOSTORE und DB2MMSTORE auf dem Server verwendet, um die Datei zu lokalisieren.

quellendatei (LONG VARCHAR)
Der Name der Quellen-Server-Datei. Der Quellendateiname kann ein vollständig qualifizierter Name oder ein nicht vollständig qualifizierter Name sein. Die Angabe eines Nullwerts oder einer leeren Zeichenfolge ist nicht gültig. Wenn der Name nicht als vollständig qualifizierter Name angegeben wird, werden die Umgebungsvariablen DB2AUDIOPATH und DB2MMPATH auf dem Server verwendet, um die Datei zu lokalisieren.

speichertyp (INTEGER)
Ein Wert, der angibt, wo der Ton gespeichert wird. Die Konstante MMDB_STORAGE_TYPE_INTERNAL (Wert=1) gibt an, daß der Ton in der Datenbank als BLOB gespeichert wird. Die Konstante MMDB_STORAGE_TYPE_EXTERNAL (Wert=0) gibt an, daß der Toninhalt in einer Server-Datei (auf die von der Datenbank aus gezeigt wird) gespeichert wird.

kommentar (LONG VARCHAR)

Zusammen mit dem Ton kann ein Kommentar gespeichert werden.

attribute (LONG VARCHAR FOR BIT DATA)
Die Attribute des Tons.

Rückgabewerte (Datentyp)

Kennung des Tons (DB2AUDIO).

Beispiele

Einfügen eines Datensatzes in die Tabelle 'employee', der einen Audioclip für Anita Jones enthält. Die Tonquelle befindet sich auf einem Client-Puffer. Speichern des Audioclips in der Tabelle als BLOB:

EXEC SQL BEGIN DECLARE SECTION;
     SQL TYPE IS BLOB (5M) aud_seg;
  EXEC SQL END DECLARE SECTION;
 
EXEC SQL INSERT INTO EMPLOYEE VALUES(
      '128557',
      'Anita Jones',
        DB2AUDIO(
         CURRENT SERVER,
         :aud_seg,
         'WAVE',
         CAST(NULL as LONG VARCHAR),
         
         'Anita''s voice'));

Einfügen eines Datensatzes in die Tabelle 'employee', der einen Audioclip für Robert Smith enthält. Die Tonquelle befindet sich in einer Server-Datei. Der Datensatz in der Tabelle 'employee' zeigt auf die Datei.

EXEC SQL BEGIN DECLARE SECTION;
long hvStorageType;
  EXEC SQL END DECLARE SECTION;
 
hvStorageType = MMDB_STORAGE_TYPE_EXTERNAL;
 
EXEC SQL INSERT INTO EMPLOYEE VALUES(
      '384779',
      'Robert Smith',
        DB2AUDIO(
         CURRENT SERVER,
         '/employee/sounds/rsmith.wav',
         'WAV',
         :hvStorageType,
         'Robert''s voice'));

Einfügen eines Datensatzes in die Tabelle 'employee', der einen Audioclip für Anita Jones enthält. Speichern des Audioclips als BLOB. Der Quellenaudioclip, der sich in einer Server-Datei befindet, hat ein benutzerdefiniertes Format, eine Abtastrate von 44,1 KHz, und zwei aufgezeichnete Kanäle.

EXEC SQL BEGIN DECLARE SECTION;
long hvStorageType;
struct {
       short len;
       char data[600];
}hvAudattr;
  EXEC SQL END DECLARE SECTION;
 
MMDBAudioAttrs          *paudiattr;
 
hvStorageType = MMDB_STORAGE_TYPE_INTERNAL;
 
paudioattr=(MMDBAudioAttrs *) hvAudattr.data;
strcpy(paudioAttr>cFormat,"cFormatA");
paudioAttr>ulSamplingRate=44100;
paudioAttr>usNumChannels=2;
hvAudattrs.len=sizeof(MMDBAudioAttrs);
 
EXEC SQL INSERT INTO EMPLOYEE VALUES(
      '128557',
      'Anita Jones',
        DB2AUDIO(
         CURRENT SERVER,
          '/employee/sounds/ajones.aud',
         :hvStorageType,
               'Anita"s voice',
               :hvAudattr)
       );


[ Seitenanfang | Vorherige Seite | Nächste Seite | Inhaltsverzeichnis | Index ]