# El manual de &kmyapplication;

## Introducció

&kmyapplication; és el component de servidor de l'eina per a l'adquisició de mostres de SSC.

Gestiona les dades dels parladors (usuaris, institucions), així com les metadades de la mostra utilitzant una base de dades i emmagatzemant les mostres.

Rep l'entrada des del client(s) SSC que es connecten al servidor utilitzant TCP/IP.

Per a més informació sobre l'arquitectura general de la suite de Simon consulteu el manual de Simon. Per obtenir informació sobre el client SSC, referiu-vos al manual de SSC.

## Usar &kmyapplication;

&kmyapplication; és una aplicació de línia d'ordres que no disposa de cap interfície d'usuari. No hi ha paràmetres especials pel llançament.

### Carpeta base

La carpeta de base de &kmyapplication; conté el fitxer de configuració `sscd.conf` i un registre d'errors en cas que alguna cosa vagi malament. Aquesta carpeta també conté la subcarpeta `samples` on s'emmagatzemaran totes les mostres.

La ubicació de la carpeta SSCd depèn del vostre sistema operatiu:

### Carpeta base de SSC

Microsoft Windows | GNU/Linux
`Carpeta d'instal·lació de sscd.exe (usualment: C:\Program Files\Simon 0.3\bin\sscd.exe`) | `/usr/share/sscd`

### Configurar

No hi ha cap configuració gràfica de SSCd, però hi ha un fitxer de configuració (`sscd.conf`) emmagatzemat a la carpeta de SSCd.

El fitxer de configuració per omissió està molt comentat i per tant és auto-explicatiu.

Abans d'executar SSCd, almenys voldreu canviar les entrades DatabaseUser i DatabasePassword del fitxer de configuració. Veure la secció base de dades per obtenir més informació.

    ; Aquest és un exemple de fitxer de configuració i mostra els valors per
    ; omissió. SSCd cercarà aquest fitxer a:
    ; Linux:
    ;    /usr/share/sscd/sscd.conf
    ; Windows:
    ;    <camí d'instal·lació de sscd>\sscd.conf

    [General]
    ; Canvieu aquesta opció per utilitzar una base de dades diferent. Perquè
    ; SSCd utilitza ordres específiques de la base de dades en els llocs, només
    ; QMYSQL és compatible en aquest moment. El suport per a d'altres DBMS
    ; es pot afegir amb molta facilitat, encara que, si us plau, no dubteu en
    ; sol·licitar ajuda a través de kde-accessibility@kde.org
    DatabaseType=QMYSQL

    ; La màquina de la DBMS
    DatabaseHost=127.0.0.1

    ; El port de la DBMS, 3306 és el port per omissió de MySQL
    DatabasePort=3306

    ; La base de dades a utilitzar. Assegureu-vos que s'executa l'script de
    ; creació subministrat abans d'utilitzar SSCd
    DatabaseName=ssc

    ; El nom d'usuari a utilitzar per connectar-vos a la DBMS
    DatabaseUser=sscuser

    ; La base de dades de les contrasenyes. La per omissió, òbviament,
    ; no funciona en la majoria dels casos.
    DatabasePassword=CANVIEU-ME ARA

    ; Les opcions de la base de dades. Consulteu la documentació de Qts de
    ; QSqlDatabase per a més detalls
    DatabaseOptions=MYSQL_OPT_RECONNECT=1

    ; El port del servidor on escolta, per omissió: 4440
    Port=4440

    ; Enllaça el servidor a una adreça IP del client. Si això és cert (true), el
    ; servidor ignorarà totes les peticions dels BoundHost (veure més a sota)
    Bind=false

    ; IP de la BoundHost (si està actiu «Bind»)
    BindHost=127.0.0.1

### La base de dades

&kmyapplication; emmagatzema les dades dels parladors i les dades de la mostra (però no les pròpies mostres) en una base de dades. De moment, només les bases de dades MySQL estan completament suportades. Afegir suport per a una nova base de dades és trivial, però. Poseu-vos en contacte amb l'equip de Simon si voleu ajudar.

Per configurar les taules requerides &kmyapplication; vé amb un script apropiat que crea `mysql_create_script.sql` instal·lat a la carpeta de base de &kmyapplication;.

Els errors de la base de dades es poden trobar al fitxer `error.log`, el qual també resideix a la carpeta base.

### El mode bloquejat

De manera opcional SSCd prendrà l'argument de la línia d'ordres «-l» (o «- locked») per activar el mode «bloquejat» (per omissió desactivat).

En el mode bloquejat, els clients encara es poden connectar i publicar les mostres, així com crear nous micròfons i targetes de so, però no tenen cap accés (de lectura o escriptura) a les dades de caràcter personal o institucional, a part del nom o ID d'usuari. Això pot ser útil per a limitar la quantitat d'informació passiva privada que es mostrarà als equips d'enregistrament.

Mentre està actiu el mode bloquejat, tampoc hi haurà cerca d'usuaris per assegurar-vos que el vostre equip d'enregistrament és proporcionat amb una llista dels ID d'usuari al davant.

### Extreure les mostres col·leccionades

Per construir els models utilitzant les mostres col·leccionades amb &kmyapplication; primer les haureu d'extreure de la base de dades.

Com que &kmyapplication; està dissenyat per a l'adquisició de mostres a gran escala aquest no acaba de ser fàcil d'utilitzar. La documentació a continuació es proporciona principalment per a professionals tècnicament qualificats.

La majoria dels següents scripts requereixen les eines de GNU (usualment disponibles per omissió sobre GNU/Linux).

Podeu utilitzar la següent consulta (seran necessaris petits ajustaments en funció de quines mostres necessiteu exactament):

    use ssc;

    select s.Path, s.Prompt
      from Sample s inner join User u
        on s.UserId = u.UserId inner join UserInInstitution uii
          on u.UserId = uii.UserId inner join SampleType st
            on s.TypeId = st.SampleTypeId inner join Microphone m
              on m.MicrophoneId = s.MicrophoneId
      WHERE st.ExactlyRepeated=1 and uii.InstitutionId = 3
        and (m.MicrophoneId = 1);

Aquesta consulta mostrarà una llista de totes les mostres de la institució 3 que es van enregistrar amb el micròfon 1.

Per exemple podeu utilitzar aquest script per crear un fitxer d'indicacions:

    #!/bin/bash
          sed '1d' $1
    > temp_out
          sed -e 's/\\\\/\//g' -e 's/.*Samples\///g' -e 's/\.wav\t/ /' temp_out
    > $1
          rm temp_out

Aquest fitxer d'indicacions es pot importar a Simon.

Per construir el diccionari adequat per compilar el model també podríeu desitjar llistar totes les frases contingudes al fitxer d'indicacions. Podeu fer-ho amb aquest script:

    #!/bin/bash
          cat $1 | sed -e 's/[0-9\/]* //' | sort | uniq

## Preguntes i respostes

En un esforç per mantenir aquesta secció sempre actualitzada està disponible al nostre wiki en línia.

## Crèdits i llicència

&kmyapplication;

Copyright del programa 2008-2010 Peter Grasch peter.grasch@bedahr.org

Copyright de la documentació © 2009-2010 Peter Grasch peter.grasch@bedahr.org

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

## Instal·lació

Si us plau, consulteu el nostre wiki per a les instruccions d'instal·lació.

&documentation.index;