Libra Winfred

2015年10月1日星期四

Android Phone 各類功能

AccelerometerListener：感應器監聽類，此類用於監聽感應加速器，會通知用戶端水準和重力感應資訊
ADNList extents ListActivity：電話的應用程式

BluetoothAtPhonebook：藍牙電話薄
BluetoothCmeError：免提設定檔中的錯誤參數
BluetoothHandsfree：藍牙免提藍牙耳機的手機應用管理器
BluetoothHeadsetService extends Service：藍牙耳機服務
ButtonGridLayout extends ViewGroup：表格按鈕樣式
CallCard extends FrameLayout implements CallTime.OnTickListener, CallerInfoAsyncQuery.OnQueryCompleteListener, ContactsAsyncHelper.OnImageLoadCompleteListener, View.OnClickListener：電話卡類通話介面提供保留通話或來電
CallFeaturesSetting extends PreferenceActivity implements DialogInterface.OnClickListener, Preference.OnPreferenceChangeListener, EditPhoneNumberPreference.OnDialogClosedListener, EditPhoneNumberPreference.GetDefaultNumberListener：通話功能設置
CallForwardEditPreference extends EditPhoneNumberPreference：來電轉接編輯
CallLogsync：通話記錄同步
CallNotifier extends Handler implements CallerInfoAsyncQuery.OnQueryCompleteListener：電話通知
CallTime extends Handle：通話時間
CallWaitingCheckBoxPreference extends CheckBoxPreference：呼叫等到核取方塊
CarrierLogo：載波微標(工具類來查找資源ID標識載體)
CdmaCallOptions extends PreferenceActivity：cdma通話選項
CdmaDisplayInfo：cdma顯示資訊
CdmaOptions：名單電話特定設置螢幕
CdmaPhoneCallState：手機呼叫狀態
CdmaSubscriptionListPreference extends ListPreference：cdma偏好設置
CdmaSystemSelectListPreference extends ListPreference：CDMA系統偏好設置
CdmaVoicePrivacyCheckBoxPreference extends CheckBoxPreference：CDMA語音隱私CheckBox設置
CellBroadcastSms extends PreferenceActivity implements Preference.OnPreferenceChangeListener：社區廣播短信電話名單設置螢幕
ChangeIccPinScreen extends Activity：手機螢幕改變程式
CLIRListPreference extends ListPreference：跨語言資訊檢索清單
DataUsage extends PreferenceActivity：資料使用
DataUsageListener：資料使用監聽為來自ThrottleManager 的廣播
DeleteFdnContactScreen extends Activity：刪除通訊錄中的資訊
DTMFTwelveKeyDialer implements SlidingDrawer.OnDrawerOpenListener, SlidingDrawer.OnDrawerCloseListener, View.OnTouchListener, View.OnKeyListener：雙音多頻撥號TwelveKeys

DTMFTwelveKeyDialerView extends LinearLayout：雙音多頻撥號器介面
EditFdnContactScreen extends Activity：編輯連絡人介面
EditPhoneNumberPreference extends EditTextPreference：電話號碼偏好編輯
EditPinPreference extends EditTextPreference：編輯引腳偏好
EmergencyCallbackModeExitDialog extends Activity implements OnDismissListener：緊急呼叫模式退出對話方塊
EmergencyCallbackModeService extends Service：緊急呼叫服務延伸服務模式
EmergencyCallHandler extends Activity：緊急呼叫處理常式
　　EmergencyDialer extends Activity implements View.OnClickListener, View.OnLongClickListener, View.OnKeyListener, TextWatcher：緊急呼叫撥號器
EnableFdnScreen extends Activity：啟用Fdn螢幕
EnableIccPinScreen extends Activity：螢幕啟用引腳電流
FakePhoneActivity extends Activity：簡單的手機類比程式
FastBitmapDrawable extends Drawable
FdnList extends ADNList
FdnSetting extends PreferenceActivity implements EditPinPreference.OnPinEnteredListener, DialogInterface.OnCancelListener：Fdn設置

GetPin2Screen extends Activity：開機獲取Pin2
GsmUmtsAdditionalCallOptions extends TimeConsumingPreferenceActivity：UMTS與GSM附加打電話選項
GsmUmtsCallForwardOptions extends TimeConsumingPreferenceActivity Gsm 與Umts來電轉接
GsmUmtsCallOptions extends PreferenceActivity：GSM與Umts呼叫選項
GsmUmtsOptions：GSM選項
HapticFeedback：觸覺感應
IccNetworkDepersonalizationPanel extends IccPanel：ICC網路人格解體小組
IccPanel extends Dialog：小組
IccProvider extends com.android.internal.telephony.IccProvider：ICC提供者提供address和book
InCallControlState：呼叫控制狀態
InCallLockScreen extends FrameLayout
InCallMenu ：來電菜單
InCallMenuItemView extends TextView：來電功能表選項介面
InCallMenuView extends ViewGroup
InCallScreen extends Activity implements View.OnClickListener, View.OnTouchListener, CallerInfoAsyncQuery.OnQueryCompleteListener：來電螢幕
InCallScreenShowActivation extends Activity：來電顯示啟動
InCallTouchUi extends FrameLayout implements View.OnClickListener, SlidingTab.OnTriggerListener：呼叫觸摸介面
ManageConferenceUtils implements CallerInfoAsyncQuery.OnQueryCompleteListener：會議管理工具
NetworkQueryService extends Service：網路查詢服務
NetworkSetting extends PreferenceActivity implements DialogInterface.OnCancelListener：網路設置
NotificationMgr implements CallerInfoAsyncQuery.OnQueryCompleteListener OtaStartupReceiver：通知消息
OtaStartupReceiver extends BroadcastReceiver：Ota接收器
OtaUtils：Ota工具類
OutgoingCallBroadcaster extends Activity：呼叫廣播
PhoneApp extends Application implements AccelerometerListener.OrientationListener：手機應用程式
PhoneInterfaceManager extends ITelephony.Stub：手機介面管理
PhoneUtils：電話工具類
ProcessOutgoingCallTest extends BroadcastReceiverProfiler：呼叫過程實驗
Profiler：探查
Ringer：林格
Rotate3dAnimation extends Animation
Settings extends PreferenceActivity implements DialogInterface.OnClickListener, DialogInterface.OnDismissListener, Preference.OnPreferenceChangeListener：設置
SimContacts extends ADNList：SIM卡連絡人
SipBroadcastReceiver extends BroadcastReceiver：廣播接收機
SipCallOptionHandler extends Activity implements DialogInterface.OnClickListener, DialogInterface.OnCancelListener, CompoundButton.OnCheckedChangeListener：電話處理常式選項
SipUtil：Sip工具類
SpecialCharSequenceMgr：特別字元序列管理
TelephonyCapabilities：電話功能
TimeConsumingPreferenceActivity extends PreferenceActivity implements TimeConsumingPreferenceListener, DialogInterface.OnClickListener, DialogInterface.OnCancelListener：耗時偏好功能
Use2GOnlyCheckBoxPreference extends CheckBoxPreference：使用只有2G卡的核取方塊偏好設置
SipEditor extends PreferenceActivity implements Preference.OnPreferenceChangeListener：Sip編輯器
SipProfileDb：個性化設置
SipSettings extends PreferenceActivity：設置
SipSharedPreferences：共用偏好

2015年6月3日星期三

[轉]GSM-Phone-Call-Connection

1.通話狀態
State {
   IDLE,//待機，沒有連接
   ACTIVE,//通話
   HOLDING,//掛斷通話
   DIALING,//響鈴
   ALERTING,//提醒
   INCOMING,//來電
   WAITING,//等待接通
   DISCONNECTED,//連接斷開後
   DISCONNECTING;//連接斷開工程中
}

2.通話失敗的原因
CallFailCause {
// Unassigned/Unobtainable number未分配的號碼
static final int UNOBTAINABLE_NUMBER = 1;
static final int NORMAL_CLEARING    = 16;
// Busy Tone對方正在通話
static final int USER_BUSY          = 17;
// No Tone
static final int NUMBER_CHANGED    = 22;
static final int STATUS_ENQUIRY    = 30;
static final int NORMAL_UNSPECIFIED  = 31;
// Congestion Tone
static final int NO_CIRCUIT_AVAIL = 34;
static final int TEMPORARY_FAILURE = 41;
static final int SWITCHING_CONGESTION = 42;
static final int CHANNEL_NOT_AVAIL = 44;
static final int QOS_NOT_AVAIL    = 49;
static final int BEARER_NOT_AVAIL = 58;
// others
static final int ACM_LIMIT_EXCEEDED = 68;
static final int CALL_BARRED       = 240;
static final int FDN_BLOCKED       = 241;
static final int ERROR_UNSPECIFIED = 0xffff;
static final int IMSI_UNKNOWN_IN_VLR = 242;
static final int IMEI_NOT_ACCEPTED = 243;
}

3.連接取消的原因
DisconnectCause {
      NOT_DISCONNECTED,/* has not yet disconnected 連接失敗*/
      INCOMING_MISSED,/* an incoming call that was missed and never answered 錯過了來電*/
      NORMAL,/* normal; remote 對方掛斷電話*/
      LOCAL,/* normal; local hangup 自己掛斷電話*/
      BUSY,/* outgoing call to busy line 撥打的號碼正在通話*/
      CONGESTION,/* outgoing call to congested network 網路擁擠*/
      MMI,/*not presently used; dial()returns null撥號的號碼未被使用*/
      INVALID_NUMBER,/* invalid dial string 無效的號碼串*/
      LOST_SIGNAL,
      LIMIT_EXCEEDED,/* eg GSM ACM limit exceeded 超出限額的GSM ACM。ACM(Association for Computing Machinery )中文：美國電腦協會是一個世界性的電腦從業員專業組織*/
      INCOMING_REJECTED,/* an incoming call that was rejected 來電被拒絕*/
      POWER_OFF,/* radio is turned off explicitly 無線網路被關閉*/
      OUT_OF_SERVICE,/* out of service 服務區外*/
      ICC_ERROR,/* No ICC, ICC locked, or other ICC error */
      CALL_BARRED,/* call was blocked by call barrring 被“呼叫限制”攔截*/
      FDN_BLOCKED,/* call was blocked by fixed dial number 被“固定撥號”攔截*/
      CS_RESTRICTED,/* call was blocked by restricted all voice access 被“拒絕語音接入”攔截*/
      CS_RESTRICTED_NORMAL,/* call was blocked by restricted normal voice access 被“拒絕通話”攔截*/
      CS_RESTRICTED_EMERGENCY,/* call was blocked by restricted emergency voice access */
      UNOBTAINABLE_NUMBER,/* Unassigned number (3GPP TS 24.008 table 10.5.123) 未分配的號碼*/
      IMSI_UNKNOWN_IN_VLR,/* IMSI is not known at the VLR VLR不能識別IMSI。國際移動用戶識別碼（IMSI：International Mobile Subscriber Identification Number）是區別移動使用者的標誌，儲存在SIM卡中，可用於區別移動使用者的有效資訊。其總長度不超過15位，同樣使用0～9的數字。其中MCC是移動用戶所屬國家代號，占3位元數字，中國的MCC規定為460；MNC是移動網號碼，最多由兩位元數位組成，用於識別移動用戶所歸屬的移動通信網；MSIN是移動用戶識別碼，用以識別某一移動通信網中的移動用戶。VLR (Visitor Location Register)：拜訪位置寄存器。是一個資料庫，是存儲所管轄區域中MS（統稱拜訪客戶）的來話、去話呼叫所需檢索的資訊以及使用者簽約業務和附加業務的資訊，例如客戶的號碼，所處位置區域的識別，向客戶提供的服務等參數。*/
      IMEI_NOT_ACCEPTED,/* network does not accept emergency call establishment using an IMEI 網路不接受使用緊急呼叫建立一個IMEI。IMEI(International Mobile Equipment Identity)是國際移動設備身份碼的縮寫，國際移動裝備辨識碼，是由15位元數位組成的"電子串號"，它與每台手機一一對應，而且該碼是全世界唯一的。每一隻手機在組裝完成後都將被賦予一個全球唯一的一組號碼，這個號碼從生產到交付使用都將被製造生產的廠商所記錄。*/
      CDMA_LOCKED_UNTIL_POWER_CYCLE,/* MS is locked until next power cycle 直到下一個電話週期，MS被關閉。MS：Mobile station 的縮寫，移動台*/
      CDMA_DROP,
      CDMA_INTERCEPT,/* INTERCEPT order received, MS state idle entered 接到攔截命令，MS進入閒置狀態*/
      CDMA_REORDER,/* MS has been redirected, call is cancelled呼叫被取消 */
      CDMA_SO_REJECT,/* service option rejection 拒絕服務選項*/
      CDMA_RETRY_ORDER,/* requeseted service is rejected, retry delay is set 請求被拒絕，設置延時重試*/
      CDMA_ACCESS_FAILURE,
      CDMA_PREEMPTED,
      CDMA_NOT_EMERGENCY,/* not an emergency call 不是緊急號碼*/
      CDMA_ACCESS_BLOCKED,/* Access Blocked by CDMA network 被CDMA網路攔截*/
      ERROR_UNSPECIFIED
}

4.電話號碼字串的狀態
PostDialState {
NOT_STARTED,/* The post dial string playback hasn't been started, or this call is not yet connected, or this is an incoming call 號碼字元未被發送出去，或者此呼叫尚未連接，或者這只是一個來電*/
STARTED,/* The post dial string playback has begun 號碼字元發送啟動*/
WAIT,/* The post dial string playback is waiting for a call to proceedAfterWaitChar()號碼字元等待調用proceedAfterWaitChar函數，如果postDialState為PostDialState.WAIT時，設置postDialState為PostDialState.STARTED，並且調用函數processNextPostDialChar開始另一個電話號碼的字串發送*/
WILD,/* The post dial string playback is waiting for a call to proceedAfterWildChar() 號碼字元等待調用proceedAfterWildChar函數，如果postDialState為PostDialState.WILD時，設置postDialState為PostDialState.STARTED，並且如果已經發出去的字串的最後一個字元不在“0-9，*，#”中，則調用函數processNextPostDialChar開始另一個電話號碼的字串發送*/
COMPLETE,/* The post dial string playback is complete 所有號碼字元都完成發送*/
CANCELLED,/* The post dial string playback was cancelled with cancelPostDial() 號碼字元取消發送*/
PAUSE/* The post dial string playback is pausing for a call to processNextPostDialChar號碼字元為調用processNextPostDialChar函數而暫停發送*/
}

5.GSMCall
一個通話可以有多個連接，其中還包含了一些偽連接，最多能有5個連接。
當所有連接都斷開後，通話狀態斷開。

當本地掛斷電話後，會設置連接取消的原因為本地掛斷。

1)撥號
註冊一個廣播接收機“android.intent.action.NEW_OUTGOING_CALL”，
但要求使用許可android.permission.PROCESS_OUTGOING_CALLS。你可以通過“BroadcastReceiver.onReceive();String strPhoneNumber = intent.getStringExtra(Intent.EXTRA_PHONE_NUMBER);”撥出電話號碼;

2)來電
使用TelephonyManager和PhoneStateListener來管理。

6.GSMConnection
1)獲取連接創建的時間，連接的時間，斷開連接的時間；通話的時間，通話被保持的時間。
2)得到連接斷開的原因。
3)通話掛斷與連接取消之間的關係：
DisconnectCause disconnectCauseFromCode(int causeCode) {
      switch (causeCode) {
         case CallFailCause.USER_BUSY:
            return DisconnectCause.BUSY;
         case CallFailCause.NO_CIRCUIT_AVAIL:
         case CallFailCause.TEMPORARY_FAILURE:
         case CallFailCause.SWITCHING_CONGESTION:
         case CallFailCause.CHANNEL_NOT_AVAIL:
         case CallFailCause.QOS_NOT_AVAIL:
         case CallFailCause.BEARER_NOT_AVAIL:
            return DisconnectCause.CONGESTION;
         case CallFailCause.ACM_LIMIT_EXCEEDED:
            return DisconnectCause.LIMIT_EXCEEDED;
         case CallFailCause.CALL_BARRED:
            return DisconnectCause.CALL_BARRED;
         case CallFailCause.FDN_BLOCKED:
            return DisconnectCause.FDN_BLOCKED;
         case CallFailCause.UNOBTAINABLE_NUMBER:
            return DisconnectCause.UNOBTAINABLE_NUMBER;
         /*Display the following call fail cause only when Adapt feature is enabled.只有在適應功能已啟用才顯示下面的調用失敗。*/
         case CallFailCause.IMSI_UNKNOWN_IN_VLR:
            if (SystemProperties.getBoolean("persist.cust.tel.adapt", false)) {
                  return DisconnectCause.IMSI_UNKNOWN_IN_VLR;
            }
         case CallFailCause.IMEI_NOT_ACCEPTED:
            if (SystemProperties.getBoolean("persist.cust.tel.adapt", false)) {
                  return DisconnectCause.IMEI_NOT_ACCEPTED;
            }
         case CallFailCause.ERROR_UNSPECIFIED:
         case CallFailCause.NORMAL_CLEARING:
         default:
            GSMPhone phone = owner.phone;
            int serviceState = phone.getServiceState().getState();
            if (serviceState == ServiceState.STATE_POWER_OFF) {
                  return DisconnectCause.POWER_OFF;
            } else if (serviceState == ServiceState.STATE_OUT_OF_SERVICE
                     || serviceState == ServiceState.STATE_EMERGENCY_ONLY ) {
                  return DisconnectCause.OUT_OF_SERVICE;
            } else if (phone.getIccCard().getState() != SimCard.State.READY) {
                  return DisconnectCause.ICC_ERROR;
            } else if (causeCode == CallFailCause.ERROR_UNSPECIFIED) {
                  if (phone.mSST.rs.isCsRestricted()) {
                     return DisconnectCause.CS_RESTRICTED;
                  } else if (phone.mSST.rs.isCsEmergencyRestricted()) {
                     return DisconnectCause.CS_RESTRICTED_EMERGENCY;
                  } else if (phone.mSST.rs.isCsNormalRestricted()) {
                     return DisconnectCause.CS_RESTRICTED_NORMAL;
                  } else {
                     return DisconnectCause.ERROR_UNSPECIFIED;
                  }
            } else if (causeCode == CallFailCause.NORMAL_CLEARING) {
                  return DisconnectCause.NORMAL;
            } else {
            /*If nothing else matches, report unknown call drop reason to app, not NORMAL call end.沒有匹配的通話失敗原因則報告未知的應用程式錯誤使得通話非正常結束*/
                  return DisconnectCause.ERROR_UNSPECIFIED;
            }
      }
}
4)獲取通話的狀態。
5)對號碼各個字元發送狀態做處理。
6)processPostDialChar為號碼字元執行適當的行動，但不通知應用程式。如果字元是無效的，返回false，並且被忽略。

7.GsmServiceStateTracker
與漫遊設置有關，與網路時間同步有關，與運營商有關...

8.GsmCallTracker
是android的通話管理層，建立了ConnectionList來管理現行的通話連接，並向上層提供電話調用介面。
在GSMCallTracker中維護著通話列表：connections。順序記錄了正連接上的通話，這些通話包括：ACTIVE，DIALING，ALERTING，HOLDING，INCOMING，WAITING等狀態的連接。GSMCallTracker將這些連接分為了三類別進行管理：
[1]RingingCall: INCOMING ,WAITING
[2]ForegourndCall: ACTIVE, DIALING ,ALERTING
[3]BackgroundCall: HOLDING