audio_stream_out Yapı Referansı
#include < audio.h >
Veri alanları | |
| struct audio_stream | yaygın |
| uint32_t(* | get_latency )(const struct audio_stream_out *stream) |
| int(* | set_volume )(struct audio_stream_out *akım, sola kayar, sağa kayar) |
| size_t(* | yaz )(struct audio_stream_out *stream, const void *buffer, size_t bayt) |
| int(* | get_render_position )(const struct audio_stream_out *akış, uint32_t *dsp_frames) |
| int(* | get_next_write_timestamp )(const struct audio_stream_out *akış, int64_t *zaman damgası) |
| int(* | set_callback )(struct audio_stream_out *stream, stream_callback_t callback, void *cookie) |
| int(* | duraklat )( audio_stream_out yapı *akım) |
| int(* | devam et )(struct audio_stream_out *stream) |
| int(* | boşaltma )(struct audio_stream_out *stream, audio_drain_type_t tipi) |
| int(* | floş )( audio_stream_out yapı *akım) |
| int(* | get_presentation_position )(const struct audio_stream_out *akış, uint64_t *kareler, struct zaman belirtimi *zaman damgası) |
Detaylı Açıklama
audio_stream_out , ses çıkış donanımı için soyutlama arabirimidir.
Ses çıkışı donanım sürücüsünün çeşitli özellikleri hakkında bilgi sağlar.
Saha Dokümantasyonu
| struct audio_stream ortak |
Ses akışının yaygın yöntemleri. Bu, audio_stream_out'un ilk üyesi olmalıdır , çünkü bu yapının kullanıcıları, audio_stream'in bir audio_stream_out referansına başvurduğu bilinen bağlamlarda audio_stream_out işaretçisine bir audio_stream yayınlayacaktır .
| int(* boşaltma)(struct audio_stream_out *stream, audio_drain_type_t türü) |
Sürücü/donanım tarafından arabelleğe alınan veriler oynatıldığında bildirim ister. Eğer set_callback() önceden bloke olmayan modu etkinleştirmek için çağrıldıysa, drenaj() bloke etmemelidir, bunun yerine hızlı bir şekilde geri dönmelidir ve geri arama yoluyla tahliyenin tamamlandığı bildirilir. set_callback() çağrılmamışsa, drenaj() tamamlanana kadar engellemelidir. type==AUDIO_DRAIN_ALL ise, önceden yazılmış tüm veriler oynatıldığında boşaltma tamamlanır. type==AUDIO_DRAIN_EARLY_NOTIFY ise, çerçevenin boşluksuz bir parça geçişi gerçekleştirmesine zaman tanımak için boşaltma, mevcut parça için tüm veriler çalınmadan kısa bir süre önce tamamlanır.
Dren, stop() ve flush() çağrısında hemen geri dönmelidir
Yüksüz oynatma için bu işlevin uygulanması zorunludur.
| int(* floş)(struct audio_stream_out *stream) |
| uint32_t(* get_latency)(const struct audio_stream_out *stream) |
| int(* get_next_write_timestamp)(const struct audio_stream_out *akış, int64_t *zaman damgası) |
| int(* get_presentation_position)(const struct audio_stream_out *akış, uint64_t *kareler, struct zaman belirtimi *zaman damgası) |
Harici bir gözlemciye sunulan ses karelerinin sayısının son sayısını döndürür. Bu, yazılmış ancak hala işlem hattında olan çerçeveleri hariç tutar. Çıkış bekleme moduna girdiğinde sayı sıfırlanmaz. Ayrıca bu sunum sayısı itibariyle CLOCK_MONOTONIC değerini döndürür. Döndürülen sayının 'son' olması beklenir, ancak olası en son değer olması gerekmez. Ancak, ilişkili zaman, döndürülen sayıya karşılık gelmelidir. Örnek: M'nin 'küçük' bir sayı olduğu N+M çerçevelerinin sunulduğunu varsayalım. O zaman N+M yerine N döndürmeye izin verilir ve zaman damgası N+M yerine N'ye karşılık gelmelidir. 'Son' ve 'küçük' terimleri tanımlanmamıştır. Uygulamanın kalitesini yansıtırlar.
Yalnızca 3.0 ve üstü.
| int(* get_render_position)(const struct audio_stream_out *akış, uint32_t *dsp_frames) |
| int(* duraklat)(struct audio_stream_out *stream) |
Ses sürücüsüne kayıttan yürütmeyi durdurmasını bildirir, ancak kuyruğa alınmış arabellekler donanım tarafından tutulur. Duraklatma/devam ettirme için kullanışlıdır. Boş uygulama, desteklenmiyorsa ancak önemsiz olmayan gecikme süresine sahip donanımlar için uygulanmalıdır. Duraklatma durumunda, ses donanımı hala güç kullanıyor olabilir. Kullanıcı, bir zaman aşımından sonra aramayı askıya almayı düşünebilir.
Yüksüz oynatma için bu işlevin uygulanması zorunludur.
| int(* özgeçmiş)(struct audio_stream_out *stream) |
| int(* set_callback)(struct audio_stream_out *stream, stream_callback_t geri arama, void *çerez) |
| int(* set_volume)(struct audio_stream_out *akım, sola kayar, sağa kayar) |
Donanımda ses karıştırmanın yapıldığı durumlarda bu yöntemi kullanın. Bu yöntem, donanımla doğrudan bir arabirim görevi görür ve birimi çerçeve aracılığıyla doğrudan uygun şekilde ayarlamanıza olanak tanır. Bu yöntem, birden çok PCM çıkışı veya MP3 veya AAC gibi donanım hızlandırmalı kodekler üretebilir.
| ssize_t(* write)(struct audio_stream_out *stream, const void *buffer, size_t bayt) |
Sürücüye ses arabelleği yazın. Yazılan bayt sayısını veya negatif bir durum_t döndürür. Hatadan önce en az bir çerçeve başarıyla yazılmışsa, sürücünün bu başarılı (kısa) bayt sayısını döndürmesi ve ardından sonraki çağrıda bir hata döndürmesi önerilir.
set_callback() önceden engellemesiz modu etkinleştirmek için çağrıldıysa, write() 'ın engellemesine izin verilmez. Yalnızca sürücü/donanım arabelleğine sığan bayt sayısını yazmalı ve ardından bu bayt sayısını döndürmelidir. Bu, istenen yazma boyutundan küçükse, sürücü/donanım arabelleğinde daha fazla alan olduğunda geri arama işlevi çağrılmalıdır.
Bu yapı için belgeler aşağıdaki dosyadan oluşturulmuştur:
- donanım/libhardware/include/hardware/ audio.h
audio_stream_out Yapı Referansı
#include < audio.h >
Veri alanları | |
| struct audio_stream | yaygın |
| uint32_t(* | get_latency )(const struct audio_stream_out *stream) |
| int(* | set_volume )(struct audio_stream_out *akım, sola kayar, sağa kayar) |
| size_t(* | yaz )(struct audio_stream_out *stream, const void *buffer, size_t bayt) |
| int(* | get_render_position )(const struct audio_stream_out *akış, uint32_t *dsp_frames) |
| int(* | get_next_write_timestamp )(const struct audio_stream_out *akış, int64_t *zaman damgası) |
| int(* | set_callback )(struct audio_stream_out *stream, stream_callback_t callback, void *cookie) |
| int(* | duraklat )( audio_stream_out yapı *akım) |
| int(* | devam et )(struct audio_stream_out *stream) |
| int(* | boşaltma )(struct audio_stream_out *stream, audio_drain_type_t tipi) |
| int(* | floş )( audio_stream_out yapı *akım) |
| int(* | get_presentation_position )(const struct audio_stream_out *akış, uint64_t *kareler, struct zaman belirtimi *zaman damgası) |
Detaylı Açıklama
audio_stream_out , ses çıkış donanımı için soyutlama arabirimidir.
Ses çıkışı donanım sürücüsünün çeşitli özellikleri hakkında bilgi sağlar.
Saha Dokümantasyonu
| struct audio_stream ortak |
Ses akışının yaygın yöntemleri. Bu, audio_stream_out'un ilk üyesi olmalıdır , çünkü bu yapının kullanıcıları, audio_stream'in bir audio_stream_out referansına başvurduğu bilinen bağlamlarda audio_stream_out işaretçisine bir audio_stream yayınlayacaktır .
| int(* boşaltma)(struct audio_stream_out *stream, audio_drain_type_t türü) |
Sürücü/donanım tarafından arabelleğe alınan veriler oynatıldığında bildirim ister. Eğer set_callback() önceden bloke olmayan modu etkinleştirmek için çağrıldıysa, drenaj() bloke etmemelidir, bunun yerine hızlı bir şekilde geri dönmelidir ve geri arama yoluyla tahliyenin tamamlandığı bildirilir. set_callback() çağrılmamışsa, drenaj() tamamlanana kadar engellemelidir. type==AUDIO_DRAIN_ALL ise, önceden yazılmış tüm veriler oynatıldığında boşaltma tamamlanır. type==AUDIO_DRAIN_EARLY_NOTIFY ise, çerçevenin boşluksuz bir parça geçişi gerçekleştirmesine zaman tanımak için boşaltma, mevcut parça için tüm veriler çalınmadan kısa bir süre önce tamamlanır.
Dren, stop() ve flush() çağrısında hemen geri dönmelidir
Yüksüz oynatma için bu işlevin uygulanması zorunludur.
| int(* floş)(struct audio_stream_out *stream) |
| uint32_t(* get_latency)(const struct audio_stream_out *stream) |
| int(* get_next_write_timestamp)(const struct audio_stream_out *akış, int64_t *zaman damgası) |
| int(* get_presentation_position)(const struct audio_stream_out *akış, uint64_t *kareler, struct zaman belirtimi *zaman damgası) |
Harici bir gözlemciye sunulan ses karelerinin sayısının son sayısını döndürür. Bu, yazılmış ancak hala işlem hattında olan çerçeveleri hariç tutar. Çıkış bekleme moduna girdiğinde sayı sıfırlanmaz. Ayrıca bu sunum sayısı itibariyle CLOCK_MONOTONIC değerini döndürür. Döndürülen sayının 'son' olması beklenir, ancak olası en son değer olması gerekmez. Ancak, ilişkili zaman, döndürülen sayıya karşılık gelmelidir. Örnek: M'nin 'küçük' bir sayı olduğu N+M çerçevelerinin sunulduğunu varsayalım. O zaman N+M yerine N döndürmeye izin verilir ve zaman damgası N+M yerine N'ye karşılık gelmelidir. 'Son' ve 'küçük' terimleri tanımlanmamıştır. Uygulamanın kalitesini yansıtırlar.
Yalnızca 3.0 ve üstü.
| int(* get_render_position)(const struct audio_stream_out *akış, uint32_t *dsp_frames) |
| int(* duraklat)(struct audio_stream_out *stream) |
Ses sürücüsüne kayıttan yürütmeyi durdurmasını bildirir, ancak kuyruğa alınmış arabellekler donanım tarafından tutulur. Duraklatma/devam ettirme için kullanışlıdır. Boş uygulama, desteklenmiyorsa ancak önemsiz olmayan gecikme süresine sahip donanımlar için uygulanmalıdır. Duraklatma durumunda, ses donanımı hala güç kullanıyor olabilir. Kullanıcı, bir zaman aşımından sonra aramayı askıya almayı düşünebilir.
Yüksüz oynatma için bu işlevin uygulanması zorunludur.
| int(* özgeçmiş)(struct audio_stream_out *stream) |
| int(* set_callback)(struct audio_stream_out *stream, stream_callback_t geri arama, void *çerez) |
| int(* set_volume)(struct audio_stream_out *akım, sola kayar, sağa kayar) |
Donanımda ses karıştırmanın yapıldığı durumlarda bu yöntemi kullanın. Bu yöntem, donanımla doğrudan bir arabirim görevi görür ve birimi çerçeve aracılığıyla doğrudan uygun şekilde ayarlamanıza olanak tanır. Bu yöntem, birden çok PCM çıkışı veya MP3 veya AAC gibi donanım hızlandırmalı kodekler üretebilir.
| ssize_t(* write)(struct audio_stream_out *stream, const void *buffer, size_t bayt) |
Sürücüye ses arabelleği yazın. Yazılan bayt sayısını veya negatif bir durum_t döndürür. Hatadan önce en az bir çerçeve başarıyla yazılmışsa, sürücünün bu başarılı (kısa) bayt sayısını döndürmesi ve ardından sonraki çağrıda bir hata döndürmesi önerilir.
set_callback() önceden engellemesiz modu etkinleştirmek için çağrıldıysa, write() 'ın engellemesine izin verilmez. Yalnızca sürücü/donanım arabelleğine sığan bayt sayısını yazmalı ve ardından bu bayt sayısını döndürmelidir. Bu, istenen yazma boyutundan küçükse, sürücü/donanım arabelleğinde daha fazla alan olduğunda geri arama işlevi çağrılmalıdır.
Bu yapı için belgeler aşağıdaki dosyadan oluşturulmuştur:
- donanım/libhardware/include/hardware/ audio.h