Home Explore Help
Sign In
cpp
/
oxygine-sound
mirror of https://github.com/oxygine/oxygine-sound
2
0
Fork 0
Files Issues 0 Wiki
Branch: master
Branches Tags
oxygine-sound
/
dependencies
/
openal
/
README

README 2.5 KB
Permalink History Raw

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374 
  1. Android
    2. 

  2. =======
    3. 

  3. https://github.com/AerialX/openal-soft-android
    4. 

  4. 

  5. Build with cmake using a toolchain file made for the Android NDK.
    6. 

  6. For example, this one works:
    7. 

  7. https://github.com/AerialX/libbricks/blob/master/cmake/toolchain.android.cmake
    8. 

  8. Use its NDK_CPU_X86, NDK_CPU_ARM, and NDK_CPU_ARM_V7A/NDK_CPU_ARM_VFPV3
    9. 

  9. options as needed to build for the various configurations.
    10. 

  10. 

  11. The OpenSL backend will be built if configured for API Level 9 (2.3) or later,
    12. 

  12. otherwise the JNI backend will be used. It's recommended that you compile
    13. 

  13. OpenAL Soft as a shared library (the default) when using the JNI backend.
    14. 

  14. 

  15. You may also try setting ANDROID_LOW_LATENCY to build the untested JNI
    16. 

  16. backend performance patch.
    17. 

  17. 

  18. Precompiled binaries are offered in the downloads tab of this repo. Not
    19. 

  19. necessarily up to date or configured to your liking.
    20. 

  20. https://github.com/AerialX/openal-soft-android/downloads
    21. 

  21. 

  22. Source Install
    23. 

  23. ==============
    24. 

  24. 

  25. To install OpenAL Soft, use your favorite shell to go into the build/
    26. 

  26. directory, and run:
    27. 

  27. 

  28. cmake ..
    29. 

  29. 

  30. Assuming configuration went well, you can then build it, typically using GNU
    31. 

  31. Make (KDevelop, MSVC, and others are possible depending on your system setup
    32. 

  32. and CMake configuration).
    33. 

  33. 

  34. Please Note: Double check that the appropriate backends were detected. Often,
    35. 

  35. complaints of no sound, crashing, and missing devices can be solved by making
    36. 

  36. sure the correct backends are being used. CMake's output will identify which
    37. 

  37. backends were enabled.
    38. 

  38. 

  39. For most systems, you will likely want to make sure ALSA, OSS, and PulseAudio
    40. 

  40. were detected (if your target system uses them). For Windows, make sure
    41. 

  41. DirectSound was detected.
    42. 

  42. 

  43. 

  44. Utilities
    45. 

  45. =========
    46. 

  46. 

  47. The source package comes with an informational utility, openal-info, and is
    48. 

  48. built by default. It prints out information provided by the ALC and AL sub-
    49. 

  49. systems, including discovered devices, version information, and extensions.
    50. 

  50. 

  51. 

  52. Configuration
    53. 

  53. =============
    54. 

  54. 

  55. OpenAL Soft can be configured on a per-user and per-system basis. This allows
    56. 

  56. users and sysadmins to control information provided to applications, as well
    57. 

  57. as application-agnostic behavior of the library. See alsoftrc.sample for
    58. 

  58. available settings.
    59. 

  59. 

  60. 

  61. Acknowledgements
    62. 

  62. ================
    63. 

  63. 

  64. Special thanks go to:
    65. 

  65. 

  66. Creative Labs for the original source code this is based off of.
    67. 

  67. 

  68. Christopher Fitzgerald for the current reverb effect implementation, and
    69. 

  69. helping with the low-pass filter.
    70. 

  70. 

  71. Christian Borss for the 3D panning code the current implementation is heavilly
    72. 

  72. based on.
    73. 

  73. 

  74. Ben Davis for the idea behind the current click-removal code.
    75.