Skip to content

Audio graphs

Category: API Collection

Overview

Define an accessible representation of your chart for VoiceOver to generate an audio graph.

Details

Topics

  • Essentials
  • Representing chart data as an audio graph
  • Chart representation
  • protocol AXChart
  • class AXChartDescriptor
  • Axis representation
  • protocol AXDataAxisDescriptor
  • class AXCategoricalDataAxisDescriptor
  • class AXNumericDataAxisDescriptor
  • Data representation
  • class AXDataPoint
  • class AXDataSeriesDescriptor
  • Live audio graphs
  • class AXLiveAudioGraph

See Also

  • Features
  • API ReferenceCustomized accessibility content
  • API ReferenceHearing device support
  • func AXNameFromColor(CGColor) -> String

  • Accessibility

  • Accessibility API
  • Audio graphs

Overview

Charts and graphs help users quickly identify important features and trends in data. Use the audio graphs API to provide all the information that VoiceOver needs to construct an audible representation of the data in your charts and graphs, making the data accessible to people who are blind or have low vision.

An audio graph turns the data in your chart into an audible representation by encoding the data on each axis as audio. Typically, the audio graph represents the x-axis as time, and the y-axis as pitch. For example, an audible representation of a scatter plot that shows a linear downward trend might be a series of individual tones descending in pitch over time. An audible representation of a stock chart might be a single continuous tone with a pitch that modulates up or down with the stock price (y-axis) as the audio plays over time (x-axis).

Topics (Grouped)

Essentials

Chart representation

  • AXChart — protocol; A protocol that declares the minimum interface necessary for an accessibility element to act as a chart.
  • AXChartDescriptor — class; An object that contains all the semantic information about an accessible chart.

Axis representation

Data representation

  • AXDataPoint — class; An object that represents a single data point in a chart.
  • AXDataSeriesDescriptor — class; An object that represents a series of data points.

Live audio graphs

  • AXLiveAudioGraph — class; An object that represents an audio graph for a live-updating, continuous data series for VoiceOver.

Features


Source: https://developer.apple.com/documentation/accessibility/audio-graphs