For Operating System Distributions: How do I know Orca works?

Yeah! If you're an operating system distributor and you're reading this page, we love you. Thank you for taking the time and care to better understand what you need to do to help ensure Orca works on your distribution. This page provides some very high level things you can do quickly to help verify Orca works on your operating system distribution.

1. Test Speech

Orca uses GNOME Speech for speech synthesis.

  • Run the gnome-speech test-speech application. Do speech synthesis engines show up? Can you get them to speak? Can you get speech to speak at the same time other audio is playing? If so, yeah! If not, then you might need to consider the following:

    • Shipping a speech synthesis engine with your operating system, such as eSpeak

    • Including gnome-speech and the GNOME Speech driver for the speech synthesis engine(s) you choose to ship

    • Figuring out how to make audio work better on your distribution, especially audio mixing

2. Test Braille

Orca uses BrlTTY and liblouis for braille. Most of you probably do not have a braille display, such as one manufactured by BAUM. If you're a big operating system distribution, however, you should consider investing in one.

  • Does BrlTTY work? Try running brltty -d /dev/term/0 -bxw -xno -p none -A auth=none -n. A little BrlTTY window should appear. Ignore all the other error-ish looking stuff you run into for now. If the BrlTTY window doesn't appear, then you have some work to do.

  • Are the Python bindings for BrlTTY installed? Run python -c "import brlapi" -- if it produces errors, you probably don't have the Python bindings installed.

  • Is liblouis installed? WDW: need to provide a way to check for this

  • Will BrlTTY automatically start when a USB braille device is plugged in? WDW: need to provide examples for how to do this.

See also the Orca WIKI page on braille.

3. Test Magnification

Orca uses GNOME Mag for magnification. For a compelling magnification experience, GNOME Mag uses various X Windows System server extensions: COMPOSITE, FIXES, DAMAGE, RANDR, and RENDER.

  • Does GNOME Mag work? Try running the magnifier -h command. The magnifier should come up in split screen mode.

  • Run orca, open the "Magnifier" preferences tab in the preferences GUI. Enable magnification by selecting the checkbox at the top of the magnifier preferences tab. The magnifier should come up in full screen mode by default. If it doesn't, you might not have the appropriate X Windows System server extensions installed/enabled, or you might be running into some odd conflict with a compositing manager, such as Compiz. If you're using Compiz, try going back to Metacity and trying again.

4. Test AT-SPI

Orca uses the AT-SPI to communicate with applications on the desktop.

  • Enable assistive technologies for your login session. You should be able to do this by checking the "Enable assistive technologies" checkbox in the "Assistive Technologies" preferences dialog and then logging out and back in again. If you're bold and really want to do the right thing, you can ship with accessibility enabled by default for your distribution. This can be done by modifying the default gconf values:

gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /desktop/gnome/interface/accessibility true
  • Login with accessibility enabled. You should not get any errors. Check xprop -root | grep AT_SPI_IOR. If you don't see an AT_SPI_IOR property on your root window, then something is wrong with your infrastructure. The usual cause of this is not setting the --libexecdir properly when building AT-SPI. Search the Orca WIKI Download/Install page for libexecdir for more information.

  • See if Orca can find all the apps running on the desktop: orca -l. The output should include a large number of applications, such as the following:


5. Test Orca

Do a quick test of Orca. This is just a very fast test to see if things are not seriously broken.

  • Run orca -no-setup. It should come up speaking and the Orca main window should appear.

  • Tab across the buttons in the Orca main window. They should speak as you tab between them.
  • Press Alt+F1 to make the GNOME "Start" menu appear. Arrow up and down in the menu items. Orca should speak them as you move between them.

  • Press Alt+Tab to switch between windows. Orca should speak the window titles.

6. Enable Accessible Login

Accessible login allows Orca to be used to log in to the system. See the Orca WIKI Accessible Login page for more information. It would be really great if you could test this and get it working on your distribution.

That's about it. Thanks for your consideration!

Projects/Orca/SmokeTest (last edited 2013-11-22 19:22:31 by WilliamJonMcCann)