Ссылка MusicPlayer

Вместе со связанными непрозрачными типами Ваше приложение может использовать аудиоплеер для игры музыкальных треков MIDI и дорожек автоматизации параметра аудиоустройства. Аудиоплеер является непрозрачным MusicPlayer тип данных.

Непрозрачные типы, используемые с аудиоплеером, описаны в следующих документах:

Функции

Создание и избавление от аудиоплееров

NewMusicPlayer (_:) NewMusicPlayer

Создает новый аудиоплеер.

Объявление

Swift

func NewMusicPlayer(_ outPlayer: UnsafeMutablePointer<MusicPlayer>) -> OSStatus

Objective C

OSStatus NewMusicPlayer ( MusicPlayer *outPlayer );

Параметры

outPlayer

На выводе, недавно создаваемом аудиоплеере.

Возвращаемое значение

Код результата

Обсуждение

Аудиоплеер может отправить свой вывод в график обработки аудиоданных в конечную точку MIDI, или к комбинации обоих.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.


    
    MusicPlayerSetSequence (_: _:)
    MusicPlayerSetSequence

Устанавливает музыкальную последовательность для аудиоплеера для игры.

Объявление

Swift

func MusicPlayerSetSequence(_ inPlayer: MusicPlayer, _ inSequence: MusicSequence) -> OSStatus

Objective C

OSStatus MusicPlayerSetSequence ( MusicPlayer inPlayer, MusicSequence inSequence );

Параметры

`inPlayer`	Аудиоплеер Вы конфигурируете.
`inSequence`	Музыкальная последовательность для аудиоплеера для игры.

Возвращаемое значение

Код результата

Обсуждение

Аудиоплеер должен быть остановлен для вызывания этой функции на нем. Установка музыкальной последовательности для проигрывателя переопределяет ранее последовательность набора.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.

См. также

MusicPlayerGetSequence


    
    MusicPlayerGetSequence (_: _:)
    MusicPlayerGetSequence

Получает музыкальную последовательность, связанную с аудиоплеером.

Объявление

Swift

func MusicPlayerGetSequence(_ inPlayer: MusicPlayer, _ outSequence: UnsafeMutablePointer<MusicSequence>) -> OSStatus

Objective C

OSStatus MusicPlayerGetSequence ( MusicPlayer inPlayer, MusicSequence *outSequence );

Параметры

`inPlayer`	Аудиоплеер, музыкальную последовательность которого Вы хотите получить.
`outSequence`	На выводе музыкальная последовательность связалась с аудиоплеером.

Возвращаемое значение

Код результата. Если аудиоплееру не устанавливали последовательность, эта функция возвраты kAudioToolboxErr_NoSequence.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.3 и позже.

См. также

MusicPlayerSetSequence

DisposeMusicPlayer (_:) DisposeMusicPlayer

Избавляется от аудиоплеера.

Объявление

Swift

func DisposeMusicPlayer(_ inPlayer: MusicPlayer) -> OSStatus

Objective C

OSStatus DisposeMusicPlayer ( MusicPlayer inPlayer );

Параметры

inPlayer

Аудиоплеер для избавления.

Возвращаемое значение

Код результата

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.

Управление воспроизведением


    
    MusicPlayerSetTime (_: _:)
    MusicPlayerSetTime

Устанавливает точку воспроизведения для аудиоплеера, в ударах.

Объявление

Swift

func MusicPlayerSetTime(_ inPlayer: MusicPlayer, _ inTime: MusicTimeStamp) -> OSStatus

Objective C

OSStatus MusicPlayerSetTime ( MusicPlayer inPlayer, MusicTimeStamp inTime );

Параметры

`inPlayer`	Аудиоплеер Вы хотите установить точку воспроизведения на.
`inTime`	Время, в ударах, для установки точки воспроизведения в.

Возвращаемое значение

Код результата

Обсуждение

В то время как аудиоплеер останавливается или игра, можно вызвать эту функцию. При игре во время вызова воспроизведение продолжается в указанной точке. Никакая проверка диапазона на inTime значение выполняется этой функцией.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.

См. также

MusicPlayerGetTime


    
    MusicPlayerGetTime (_: _:)
    MusicPlayerGetTime

Понимает мысль воспроизведения для аудиоплеера, в ударах.

Объявление

Swift

func MusicPlayerGetTime(_ inPlayer: MusicPlayer, _ outTime: UnsafeMutablePointer<MusicTimeStamp>) -> OSStatus

Objective C

OSStatus MusicPlayerGetTime ( MusicPlayer inPlayer, MusicTimeStamp *outTime );

Параметры

`inPlayer`	Аудиоплеер Вы хотите понять мысль воспроизведения для.
`outTime`	На выводе, точке воспроизведения для аудиоплеера.

Возвращаемое значение

Код результата.

Обсуждение

Для преобразования между ударами и секунды, посмотрите MusicSequenceGetSecondsForBeats и MusicSequenceGetBeatsForSeconds.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.

См. также

MusicPlayerSetTime

MusicPlayerPreroll (_:) MusicPlayerPreroll

Подготавливает аудиоплеер для игры.

Объявление

Swift

func MusicPlayerPreroll(_ inPlayer: MusicPlayer) -> OSStatus

Objective C

OSStatus MusicPlayerPreroll ( MusicPlayer inPlayer );

Параметры

inPlayer

Аудиоплеер, чтобы подготовить играть.

Возвращаемое значение

Код результата

Обсуждение

Вызовите эту функцию перед воспроизведением для сокращения задержки запуска аудиоплеера. Если Вы вызываете MusicPlayerStart сначала не вызывая эту функцию, проигрыватель вызовет эту функцию перед начинающимся воспроизведением.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.
MusicPlayerStart (_:) MusicPlayerStart

Запускает воспроизведение аудиоплеера.

Объявление

Swift

func MusicPlayerStart(_ inPlayer: MusicPlayer) -> OSStatus

Objective C

OSStatus MusicPlayerStart ( MusicPlayer inPlayer );

Параметры

inPlayer

Аудиоплеер для запуска.

Возвращаемое значение

Код результата

Обсуждение

Если Вы вызываете эту функцию без первого вызова MusicPlayerPreroll, проигрыватель вызовет ту функцию перед начинающимся воспроизведением.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.

См. также

MusicPlayerStop
MusicPlayerStop (_:) MusicPlayerStop

Воспроизведение остановок аудиоплеера.

Объявление

Swift

func MusicPlayerStop(_ inPlayer: MusicPlayer) -> OSStatus

Objective C

OSStatus MusicPlayerStop ( MusicPlayer inPlayer );

Параметры

inPlayer

Аудиоплеер для остановки.

Возвращаемое значение

Код результата

Обсуждение

Аудиоплееры должны быть явно остановлены. В частности, когда его связанная музыкальная последовательность полностью игралась, аудиоплеер автоматически не останавливается.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.

См. также

MusicPlayerStart


    
    MusicPlayerIsPlaying (_: _:)
    MusicPlayerIsPlaying

Указывает, играет ли аудиоплеер.

Объявление

Swift

func MusicPlayerIsPlaying(_ inPlayer: MusicPlayer, _ outIsPlaying: UnsafeMutablePointer<Boolean>) -> OSStatus

Objective C

OSStatus MusicPlayerIsPlaying ( MusicPlayer inPlayer, Boolean *outIsPlaying );

Параметры

`inPlayer`	Аудиоплеер для запросов.
`outIsPlaying`	На выводе `true` (ненулевой) при игре, `false` (нуль), не играя.

Возвращаемое значение

Код результата

Обсуждение

Если аудиоплеер начал играть и не был явно остановлен, outIsPlaying значение true. В частности, если музыкальная последовательность проигрывателя завершилась — таким образом, нет никакого более слышимого вывода — но проигрыватель не был явно остановлен, outIsPlaying значение true и временная стоимость аудиоплеера продолжает увеличиваться.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.2 и позже.

См. также

Функция


    
    MusicPlayerSetPlayRateScalar (_: _:)
    MusicPlayerSetPlayRateScalar

Устанавливает множитель скорости воспроизведения для аудиоплеера.

Объявление

Swift

func MusicPlayerSetPlayRateScalar(_ inPlayer: MusicPlayer, _ inScaleRate: Float64) -> OSStatus

Objective C

OSStatus MusicPlayerSetPlayRateScalar ( MusicPlayer inPlayer, Float64 inScaleRate );

Параметры

`inPlayer`	Аудиоплеер, на котором Вы хотите установить множитель скорости воспроизведения.
`inScaleRate`	Множитель скорости воспроизведения для применения к аудиоплееру. Например, установка этого параметра на значение 2 удваивает скорость воспроизведения. Должно быть больше, чем 0.

Возвращаемое значение

Код результата

Обсуждение

Множитель скорости воспроизведения аудиоплеера по умолчанию 1.0.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.3 и позже.

См. также

MusicPlayerGetPlayRateScalar


    
    MusicPlayerGetPlayRateScalar (_: _:)
    MusicPlayerGetPlayRateScalar

Получает множитель скорости воспроизведения для аудиоплеера.

Объявление

Swift

func MusicPlayerGetPlayRateScalar(_ inPlayer: MusicPlayer, _ outScaleRate: UnsafeMutablePointer<Float64>) -> OSStatus

Objective C

OSStatus MusicPlayerGetPlayRateScalar ( MusicPlayer inPlayer, Float64 *outScaleRate );

Параметры

`inPlayer`	Аудиоплеер, от которого Вы хотите получить множитель скорости воспроизведения.
`outScaleRate`	Множитель скорости воспроизведения аудиоплеера.

Возвращаемое значение

Код результата

Обсуждение

Множитель скорости воспроизведения аудиоплеера по умолчанию 1.0.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.3 и позже.

См. также

MusicPlayerSetPlayRateScalar

Работа со временем


    
    MusicPlayerGetHostTimeForBeats (_: _: _:)
    MusicPlayerGetHostTimeForBeats

Связали время узла с указанным ударом.

Объявление

Swift

func MusicPlayerGetHostTimeForBeats(_ inPlayer: MusicPlayer, _ inBeats: MusicTimeStamp, _ outHostTime: UnsafeMutablePointer<UInt64>) -> OSStatus

Objective C

OSStatus MusicPlayerGetHostTimeForBeats ( MusicPlayer inPlayer, MusicTimeStamp inBeats, UInt64 *outHostTime );

Параметры

`inPlayer`	Аудиоплеер, который Вы запрашиваете.
`inBeats`	Число удара, для которого Вы хотите время узла.
`outHostTime`	На выводе время узла связалось с `inBeats` значение.

Возвращаемое значение

Код результата. Если проигрыватель не играет, эта функция возвращает ошибку.

Обсуждение

Эта функция допустима, только если играет аудиоплеер. Для преобразования между ударами и секунды, посмотрите MusicSequenceGetSecondsForBeats и MusicSequenceGetBeatsForSeconds.

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.2 и позже.

См. также

MusicPlayerGetBeatsForHostTime


    
    MusicPlayerGetBeatsForHostTime (_: _: _:)
    MusicPlayerGetBeatsForHostTime

Добирается число удара связало указанное время узла.

Объявление

Swift

func MusicPlayerGetBeatsForHostTime(_ inPlayer: MusicPlayer, _ inHostTime: UInt64, _ outBeats: UnsafeMutablePointer<MusicTimeStamp>) -> OSStatus

Objective C

OSStatus MusicPlayerGetBeatsForHostTime ( MusicPlayer inPlayer, UInt64 inHostTime, MusicTimeStamp *outBeats );

Параметры

`inPlayer`	Аудиоплеер, который Вы запрашиваете.
`inHostTime`	Время узла, когда Вы хотите число удара для.
`outBeats`	На выводе число удара связалось с `inHostTime` значение.

Возвращаемое значение

Код результата. Если проигрыватель не играет, эта функция возвращает ошибку.

Обсуждение

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.2 и позже.

См. также

MusicPlayerGetHostTimeForBeats

Типы данных

MusicTimeStamp MusicTimeStamp

Музыкальная метка времени.

Объявление

Swift

typealias MusicTimeStamp = Float64

Objective C

typedef Float64 MusicTimeStamp;

Оператор импорта

Objective C

@import AudioToolbox;

Swift

import AudioToolbox

Доступность

Доступный в OS X v10.0 и позже.
MusicPlayer

Аудиоплеер играет музыкальную последовательность (типа MusicSequence).

Объявление

Swift

typealias MusicPlayer = COpaquePointer

Objective C

typedef struct OpaqueMusicPlayer *MusicPlayer;

Доступность

Доступный в OS X v10.0 и позже.

Коды результата

Эта таблица приводит коды результата, определенные для MusicPlayer непрозрачный тип и связанные непрозрачные типы: MusicEventIterator, MusicSequence, и MusicTrack.

kAudioToolboxErr_InvalidSequenceType

Значение

- 10846

Описание

Доступный в OS X v10.5 и позже.
kAudioToolboxErr_TrackIndexError

Значение

- 10859

Описание

Доступный в OS X v10.0 и позже.
kAudioToolboxErr_TrackNotFound

Значение

- 10858

Описание

Доступный в OS X v10.0 и позже.
kAudioToolboxErr_EndOfTrack

Значение

- 10857

Описание

Доступный в OS X v10.0 и позже.
kAudioToolboxErr_StartOfTrack

Значение

- 10856

Описание

Доступный в OS X v10.0 и позже.
kAudioToolboxErr_IllegalTrackDestination

Значение

- 10855

Описание

Доступный в OS X v10.1 и позже.
kAudioToolboxErr_NoSequence

Значение

- 10854

Описание

Доступный в OS X v10.1 и позже.
kAudioToolboxErr_InvalidEventType

Значение

- 10853

Описание

Доступный в OS X v10.2 и позже.
kAudioToolboxErr_InvalidPlayerState

Значение

- 10852

Описание

Доступный в OS X v10.2 и позже.
kAudioToolboxErr_CannotDoInCurrentContext

Значение

- 10863

Описание

Доступный в OS X v10.3 и позже.